antworkDOCS

Inicio rápido

Cuatro peticiones te llevan de cero a un borrador guardado en una de tus cuentas. El borrador no envía nada, así que puedes probarlo con una cuenta real.

1. Crea una clave de API

Abre Claves de API en tu espacio de trabajo y crea una clave con los permisos read y write. Solo se muestra una vez, así que guárdala antes de cerrar el diálogo. Los ejemplos la leen de una variable de entorno.

Obtener una clave de API
Shell
export ANTWORK_API_KEY="ak_a1b2c3d4e5f6a7b8_<secret>"

2. Encuentra el id de una cuenta

Crear una publicación requiere ids de cuenta, y es aquí donde se obtienen. Copia el id de la cuenta en la que quieres publicar.

curl https://antwork.io/api/v1/accounts \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

3. Guarda un borrador

"draft": true guarda la publicación y no envía nada; por eso basta con una clave write. Quítalo, con una clave que tenga publish, cuando quieras que la publicación salga.

curl https://antwork.io/api/v1/posts \
  -H "Authorization: Bearer $ANTWORK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "accounts": ["acc_linkedin"],
    "text": "Hello from the Antwork API.",
    "draft": true
  }'

4. Comprueba la publicación

Usa el id de la respuesta. Un borrador se queda en draft. Una publicación que sale pasa a published, con publishedUrl indicando dónde quedó, o a failed, con error explicando por qué.

curl https://antwork.io/api/v1/posts/pQ7x... \
  -H "Authorization: Bearer $ANTWORK_API_KEY"
¿Prefieres manejar Antwork desde Claude o ChatGPT? Eso no necesita clave: añade https://api.antwork.io/mcp como conector. La página del servidor MCP tiene los pasos para cada cliente. MCP →