Social Media Tools AI API (Tools)

This page documents the Social Media Tools / SocialGPT-specific API surface.

This is intentionally separate from:

• OpenAI Engine docs: /docs/en/ai/openai
• Copilot docs: /docs/en/ai/copilot

Scope and auth model

Social Media Tools AI endpoints are intended for SocialGPT/browser-extension style traffic.

• primary token scope: ai.socialgpt
• legacy alias accepted: ai.client
• token source is your personal Tools token from /keys/mine

Endpoints

POST /api/ai/socialgpt/respond

SocialGPT-style reply/verify/modify endpoint.

Use this for extension/client contracts that depend on SocialGPT fields and behavior.

GET /api/social-media-tools/extension/validate-token

Validates token shape/scope for extension flows.

GET /api/social-media-tools/extension/test

POST /api/social-media-tools/extension/test

Extension smoke-test endpoints.

GET /api/social-media-tools/extension/models (legacy alias)

Backward-compatible alias for GET /api/ai/models.

For new clients, use /api/ai/models.

Important separation

• Social Media Tools API traffic is not the same as generic internal OpenAI runtime traffic.
• For generic internal assistant/runtime integrations, use /api/ai/internal/respond and read /docs/en/ai/openai.