Docs
Queue
GET
/profiles/{id}/queue/slots

The next slots of the queue, each with the post that holds it. Free slots have postId: null; the first free one is where addToQueue puts the next post. Empty when the queue is off or has no slots.

Requires profiles:read.

Authorization

bearerAuth
AuthorizationBearer <token>

API key starting with fh_

In: header

Path Parameters

id*string

Profile id

Match^prof_[0-9a-fA-F]{32}$

Query Parameters

count?integer

How many slots, 1 to 100

Default10
Range1 <= value <= 100
free?string

true lists only free slots

Value in"true" | "false"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://feedhorizon.com/api/v1/profiles/prof_0195f0a27b3c7d4e8f5a1b2c3d4e5f60/queue/slots"
{
  "data": {
    "slots": [
      {
        "at": "2026-11-10T08:00:00.000Z",
        "postId": "post_0195f0a27b3c7d4e8f5a1b2c3d4e5f60",
        "postContent": "string"
      }
    ]
  }
}
{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_failed",
    "message": "One or more fields are invalid, see details",
    "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": "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"
  }
}

Set the queue of a profile PUT

Replaces all slots. `timezone` changes the profile's time zone. With `reshuffle: true`, posts already waiting in the queue move to the new slots in the order they were added; otherwise they keep their times. Send `slots: []` to clear the queue. Requires `profiles:write`.

List connected accounts GET

Requires `accounts:read`.