Profiles
Only the fields you send change. Setting isDefault moves the default flag from the previous default profile.
Requires profiles:write.
Authorization
bearerAuth AuthorizationBearer <token>
API key starting with fh_
In: header
Path Parameters
id*string
Profile id
Match
^prof_[0-9a-fA-F]{32}$Header Parameters
Idempotency-Key?string
Any unique string up to 255 characters. A retry with the same key within 24 hours returns the first response instead of running again.
Length
length <= 255Request Body
application/json
name?string
Length
1 <= length <= 100color?string
Match
^#[0-9a-fA-F]{6}$timezone?string
IANA time zone, e.g. Europe/Berlin
isDefault?boolean
queueEnabled?boolean
externalId?|
Your own id for this profile. null removes it
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://feedhorizon.com/api/v1/profiles/prof_0195f0a27b3c7d4e8f5a1b2c3d4e5f60" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"id": "prof_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
"name": "Soup Club",
"color": "#f5d76e",
"timezone": "Europe/Berlin",
"isDefault": true,
"queueEnabled": true,
"externalId": "cus_1042",
"createdAt": "2026-11-10T08:00:00.000Z",
"updatedAt": "2026-11-10T08:00:00.000Z"
}
}{
"error": {
"type": "invalid_request_error",
"code": "invalid_json",
"message": "The body is not valid JSON",
"docUrl": "https://feedhorizon.com/docs/api/errors#invalid_request_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}{
"error": {
"type": "authentication_error",
"code": "missing_api_key",
"message": "No Authorization: Bearer header",
"docUrl": "https://feedhorizon.com/docs/api/errors#authentication_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}{
"error": {
"type": "permission_error",
"code": "insufficient_scope",
"message": "The key lacks the scope for this endpoint",
"docUrl": "https://feedhorizon.com/docs/api/errors#permission_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}{
"error": {
"type": "not_found_error",
"code": "resource_not_found",
"message": "The resource does not exist, belongs to another organization, or the key cannot see its profile. A malformed id is also a 404",
"docUrl": "https://feedhorizon.com/docs/api/errors#not_found_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}{
"error": {
"type": "conflict_error",
"code": "external_id_taken",
"message": "Another profile already uses this externalId",
"docUrl": "https://feedhorizon.com/docs/api/errors#conflict_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}{
"error": {
"type": "idempotency_error",
"code": "idempotency_key_reused",
"message": "The key was used for a different request. Use a new key",
"docUrl": "https://feedhorizon.com/docs/api/errors#idempotency_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}{
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"message": "Too many requests. Wait the seconds in Retry-After",
"docUrl": "https://feedhorizon.com/docs/api/errors#rate_limit_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}{
"error": {
"type": "api_error",
"code": "internal_error",
"message": "Something failed on our side. Retry with backoff, using the same Idempotency-Key for writes",
"docUrl": "https://feedhorizon.com/docs/api/errors#api_error",
"requestId": "req_m2x81a0kfd3h9s"
}
}