Skip to main content
GET
/
api
/
agent
/
articles
/
{id}
Get queued article generation status or result by ID
curl --request GET \
  --url https://www.citedy.com/api/agent/articles/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "queued": true,
  "topic": "<string>",
  "message": "<string>",
  "article_id": "<string>",
  "title": "<string>",
  "slug": "<string>",
  "article_url": "<string>",
  "word_count": 123,
  "credits_used": 123,
  "estimated_total_credits": 123,
  "reason": "<string>",
  "error": "<string>",
  "trust_level": "<string>",
  "extensions": {
    "illustrations": "<unknown>",
    "audio": "<unknown>",
    "competition_intelligence": true
  }
}

Authorizations

​
Authorization
string
header
required

Bearer citedy_agent_* key

Path Parameters

​
id
string<uuid>
required

The job ID returned by POST /api/agent/autopilot when wait_for_completion is false

Response

Job status or completed article result

​
status
enum<string>
required

processing — generation in progress. generated — draft, not yet published. publishing — publish pipeline triggered. published — live on blog. failed — generation or publish failed.

Available options:
processing,
generated,
publishing,
published,
failed
​
id
string<uuid>
​
queued
boolean
​
topic
string
​
message
string
​
article_id
string
​
title
string
​
slug
string
​
article_url
string<uri>

URL where the article will be accessible once published. Returns 404 for draft (generated) articles until published.

​
mode
enum<string>
Available options:
standard,
turbo,
turbo+
​
word_count
integer
​
credits_used
number
​
estimated_total_credits
number
​
reason
string
​
error
string
​
trust_level
string
​
extensions
object