Articles

Get article

GET /articles/{article_id}

Retrieve an article's details including brief and draft Google Doc links.

Description: Returns article metadata, current status, writer info, and attached files. Use this to check the current state of a brief or draft before submitting updates.

Path parameters

Request

curl "https://api.presscart.com/articles/eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee" \
  -H "Authorization: Bearer $PRESSCART_API_TOKEN"

Response

{
  "id": "eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee",
  "name": "Premium Tech Feature",
  "brief_google_doc_url": "https://docs.google.com/document/d/abc123/edit",
  "draft_google_doc_url": null,
  "live_url": null,
  "campaign_id": "66666666-6666-6666-6666-666666666666",
  "product_id": "33333333-3333-3333-3333-333333333333",
  "profile_id": "22222222-2222-2222-2222-222222222222",
  "updated_at": "2026-03-20T10:00:00.000Z",
  "writer": {
    "id": "wwwwwwww-wwww-wwww-wwww-wwwwwwwwwwww",
    "first_name": "Jane",
    "last_name": "Smith"
  },
  "support_agent": null,
  "status": {
    "name": "Pending Content Brief",
    "prefix": "pending-content-brief",
    "color": "#F59E0B"
  },
  "files": [],
  "expected_completion_date": "2026-04-10T00:00:00.000Z",
  "expected_completion_date_title": "Estimated Brief Date"
}

Update article

PUT /articles/{article_id}

Update an article's content brief Google Doc link.

Description: Use this endpoint to attach a Google Doc link as a content brief. All fields are optional — only send the fields you want to update. To submit a draft, use the Approve draft endpoint instead.

Path parameters

Body

Request

curl -X PUT "https://api.presscart.com/articles/eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee" \
  -H "Authorization: Bearer $PRESSCART_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "brief_google_doc_url": "https://docs.google.com/document/d/abc123/edit"
  }'

Response

Returns the full updated article object.

Approve brief

PATCH /articles/{article_id}/approve-brief

Approve the content brief for an article.

Description: Marks the article's content brief as approved, advancing the article to the next stage in the workflow.

Path parameters

Request

curl -X PATCH "https://api.presscart.com/articles/eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee/approve-brief" \
  -H "Authorization: Bearer $PRESSCART_API_TOKEN"

Response

Returns the updated article object.

Approve draft

PATCH /articles/{article_id}/approve-draft

Submit and approve a draft for an article via Google Doc link.

Description: This is the endpoint to use when submitting a draft. Provide a draft_google_doc_url with your Google Doc link and the draft will be saved and approved in a single step. Make sure the Google Doc is shared with "Anyone with the link" set to "Editor" so writers can review and make changes.

Path parameters

Body

Request

curl -X PATCH "https://api.presscart.com/articles/eeeeeeee-eeee-eeee-eeee-eeeeeeeeeeee/approve-draft" \
  -H "Authorization: Bearer $PRESSCART_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "draft_google_doc_url": "https://docs.google.com/document/d/xyz789/edit"
  }'

Response

Returns the updated article object.