---
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
    - `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

- **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/2df2182b5901/schema)