Browse docs▾

REST Tools API Reference

Direct HTTP JSON API endpoints for invoking agent tools programmatically.

In addition to MCP and the CLI, auto-social.io provides direct REST endpoints to execute agent tools from scripts, webhooks, or backend services.

Base URL

text
https://auto-social.io/api/v1/tools

All requests must be POST requests and include:

  • Authorization: Bearer <API_KEY> header.
  • Content-Type: application/json header.

Endpoints

1. List Available Tools

Retrieve tool specifications, schemas, and descriptions.

  • Endpoint: GET /api/v1/tools
  • Response: JSON array of available tools and parameter definitions.

2. Invoke a Tool

Execute an individual tool by name.

  • Endpoint: POST /api/v1/tools/:toolName
  • Body: JSON object containing tool arguments and optional metadata.

Example: List Campaigns

bash
curl -X POST https://auto-social.io/api/v1/tools/list_campaigns \  -H "Authorization: Bearer ask_..." \  -H "Content-Type: application/json" \  -d '{    "status": "active",    "detailed": true  }'

Example: Publish Post

bash
curl -X POST https://auto-social.io/api/v1/tools/publish_post \  -H "Authorization: Bearer ask_..." \  -H "Content-Type: application/json" \  -d '{    "post_id": "00000000-0000-0000-0000-000000000000",    "integration_ids": ["11111111-1111-1111-1111-111111111111"],    "idempotency_key": "custom-uuid-key"  }'

Standard Error Responses

Errors return standard HTTP status codes with a JSON error payload:

json
{  "error": "Post not found or unauthorized",  "status": 404}
  • 400 Bad Request: Missing required arguments or malformed JSON payload.
  • 401 Unauthorized: Missing, expired, or invalid API key.
  • 403 Forbidden: Insufficient permissions or action confirmation required.
  • 404 Not Found: Target resource does not exist in your account.
  • 429 Too Many Requests: Account rate limit exceeded.