Skip to content
warmupDocs

List publications

GET
/projects/{id}/publications
curl --request GET \
  --url https://api.warmup.social/projects/00000000-0000-0000-0000-000000000000/publications \
  --header 'Authorization: Bearer <token>'

With from and to — the planner window: publications whose scheduledAt is in [from, to) plus every draft without a date. Without them — the 50 most recent.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Example 

00000000-0000-0000-0000-000000000000

Project UUID.

Query Parameters

Section titled “Query Parameters”
from
string format: date-time

Window start (inclusive), ISO 8601 with offset. Pass together with to.

to
string format: date-time

Window end (exclusive), ISO 8601 with offset. Pass together with from.

Responses

Section titled “Responses”

200

Section titled “200”

The project’s publications.

Media typeapplication/json
object
publications
required
Array<object>
object
id
required
string format: uuid
kind
required
string
Allowed values: text photo story
state
required

draft and scheduled — not sent yet. After sending: publishing while any network is still in progress, published when every network succeeded, otherwise failed (see targets[] for the per-network outcome).

string
Allowed values: draft scheduled publishing published failed
platforms
required
Array<string>
Allowed values: facebook instagram threads
text
required
string
nullable
media
required
object
id
required
string format: uuid
url
required
string format: uri
width
required
integer
height
required
integer
scheduledAt
required

When the publication goes (or went) out. null only for a draft without a date.

string format: date-time
nullable
timezone
required
string
createdAt
required
string format: date-time
updatedAt
required
string format: date-time
targets
required

Per-network outcome. Empty until the publication is sent.

Array<object>
object
platform
required
string
Allowed values: facebook instagram threads
status
required
string
Allowed values: queued publishing published failed
externalPostId
required
string
nullable
permalink
required
string
nullable
errorCode
required

Why the target failed. published_unconfirmed — Meta published the post but did not return its id; the post most likely went out.

string
nullable
Allowed values: connection_missing connection_not_ready media_not_found media_aspect_ratio needs_reauth rate_limit meta_unavailable media_rejected published_unconfirmed
publishedAt
required
string format: date-time
nullable

Example 

{
  "publications": [
    {
      "kind": "text",
      "state": "draft",
      "platforms": [
        "facebook"
      ],
      "media": {
        "width": 1080,
        "height": 1350
      },
      "timezone": "Europe/Kyiv",
      "targets": [
        {
          "platform": "facebook",
          "status": "queued",
          "errorCode": "connection_missing"
        }
      ]
    }
  ]
}

400

Section titled “400”

Invalid request.

Media typeapplication/json
object
statusCode
required
integer
message
required
One of:
string
error
string
key
additional properties
any

Example 

{
  "statusCode": 400,
  "message": "Invalid request",
  "error": "Bad Request"
}

401

Section titled “401”

The Bearer token is missing or invalid.

Media typeapplication/json
object
statusCode
required
integer
message
required
One of:
string
error
string
key
additional properties
any

Example 

{
  "statusCode": 400,
  "message": "Invalid request",
  "error": "Bad Request"
}

404

Section titled “404”

The requested resource was not found.

Media typeapplication/json
object
statusCode
required
integer
message
required
One of:
string
error
string
key
additional properties
any

Example 

{
  "statusCode": 400,
  "message": "Invalid request",
  "error": "Bad Request"
}