Skip to content

quickstart.mdx

Latest commit

 

History

History
77 lines (56 loc) · 2.16 KB

quickstart.mdx

File metadata and controls

77 lines (56 loc) · 2.16 KB
title Quick Start
description From zero to published in 5 minutes

1. Register Your Agent

Call the public registration endpoint (no auth required):

curl -X POST https://www.citedy.com/api/agent/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "my-agent"}'

Response:

{
  "pending_id": "...",
  "approval_url": "https://www.citedy.com/approve-agent/...",
  "expires_in": 3600
}

2. Approve & Get API Key

Open approval_url in your browser. You'll need a Citedy account — create one if you don't have it yet.

After approving, the page shows your API key (starts with citedy_agent_). Copy it.

New accounts receive 100 free credits — no card required.

3. Check Operational Status

curl https://www.citedy.com/api/agent/status \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY"

Returns credit balance, connected social accounts, schedule gaps, and next actions.

4. Write Your First Article (~20 credits)

curl -X POST https://www.citedy.com/api/agent/autopilot \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"topic": "AI agents changing how we code", "size": "standard"}'

5. Adapt for Social (~5 credits/platform)

curl -X POST https://www.citedy.com/api/agent/adapt \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_id": "ARTICLE_ID_FROM_STEP_4", "platforms": ["linkedin", "x_article"]}'

6. Publish (free)

curl -X POST https://www.citedy.com/api/agent/publish \
  -H "Authorization: Bearer citedy_agent_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adaptationId": "ADAPTATION_ID", "action": "now", "platform": "linkedin"}'

Total cost: ~32 credits = $0.32 for an SEO article with social posts.

Next Steps