Check Post Status

GET https://embed-api.postnitro.ai/post/status/{embedPostId}

Retrieves the current status and processing logs for a specific post. Use this to poll the progress of a carousel after initiating it via AI Generation or Content Import.

Headers

embed-api-key: your-api-key-here (required)

Path Parameters

Parameter	Type	Required	Description
`embedPostId`	string	Yes	ID of the embed post to check

Example Request


curl --location 'https://embed-api.postnitro.ai/post/status/[embed-post-id]' \
--header 'embed-api-key: pn-your-api-key'

Response


{
    "success": true,
    "data": {
        "embedPostId": "post123",
        "embedPost": {
            "id": "post123",
            "postType": "CAROUSEL",
            "status": "COMPLETED",
            "createdAt": "2024-01-15T10:30:00Z",
            "updatedAt": "2024-01-15T10:35:00Z"
        },
        "logs": [
            {
                "id": "log1",
                "embedPostId": "post123",
                "step": "INITIATED",
                "status": "SUCCESS",
                "message": "Post generation initiated",
                "timestamp": "2024-01-15T10:30:00Z"
            },
            {
                "id": "log2",
                "embedPostId": "post123",
                "step": "PROCESSING",
                "status": "SUCCESS",
                "message": "Content generated successfully",
                "timestamp": "2024-01-15T10:32:00Z"
            },
            {
                "id": "log3",
                "embedPostId": "post123",
                "step": "COMPLETED",
                "status": "SUCCESS",
                "message": "Post generation completed",
                "timestamp": "2024-01-15T10:35:00Z"
            }
        ]
    }
}

AI image generation step

If the post was initiated with generateImages, a GENERATE_IMAGES step appears in logs:

Success → status: "COMPLETED", message Generated N AI image(s) successfully.
Failure/skip → status: "FAILED", message Skipped AI image generation: <reason> (e.g. free plan or over the org’s AI-image quota).

Image generation is best-effort: even when the GENERATE_IMAGES step is FAILED, the overall post status still becomes COMPLETED — the post is simply produced without images. Generating images adds latency, so keep polling until the post is COMPLETED.

Post Status Values

Status	Meaning	What to do
`PENDING`	The post is queued or still being generated	Keep polling this endpoint (a few seconds between polls is sufficient; generation typically completes well under a minute)
`COMPLETED`	Generation finished successfully	Call Get Post Output to retrieve the files
`FAILED`	Generation failed	Inspect the `logs` array in the response for the failing step and error message, then retry or contact support@postnitro.ai