---
title: "Generate social adaptations"
method: POST
path: "/api/agent/adapt"
tags: ["Adaptations"]
---

# Generate social adaptations

`POST /api/agent/adapt`

## Request body

- AdaptRequest
  - `article_id` string, uuid, required
  - `platforms` string[], required
  - `include_ref_link` boolean

## Response `200`

Adaptations generated

- AdaptResponse
  - `adaptations` AdaptationItem[], required
    - `adaptationId` string, uuid, required — Adaptation UUID — pass directly to publish endpoint
    - `accountId` string, uuid, nullable, required — Social account UUID — pass directly to publish endpoint (null if not connected)
    - `platform` string, required
    - `content` string, required
    - `credits_used` number, required
    - `char_count` integer, required
    - `published` boolean, required
    - `platform_post_id` string, nullable, required
  - `total_credits` number, required
  - `ref_link_appended` boolean, required
  - `errors` object[]
    - `platform` string, required
    - `error` string, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `402` — Insufficient credits
- `404` — Not found
- `429` — Rate limit exceeded
- `500` — Internal server error

## Changes

> 28 revisions in range; 1 could not be searched.

- **2026-03-04** `a627bd84b6eb` — 2 info
  - added the required property `adaptations/items/accountId` to the response with the `200` status
  - added the required property `adaptations/items/adaptationId` to the response with the `200` status
- **2026-03-01** `2df2182b5901` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/citedy/apis/citedy-agent-api/changes/api/agent/adapt/post.md)

---

[API](https://skmtc.dev/citedy/apis/citedy-agent-api.md) · [All operations](https://skmtc.dev/citedy/apis/citedy-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/citedy/citedy-agent-api/revisions/b5785d3fe446/schema)