API Overview

The TaskForceAI Developer API allows you to orchestrate multi-agent workflows programmatically. API keys, model access, and usage are managed in the TaskForceAI Console.

Authentication

All Developer API requests require an x-api-key header.

x-api-key: your-api-key-here

Base URL

Developer API requests use this base URL:

https://taskforceai.chat/api/v1/developer

Core Endpoints

Submit a Task

Submit a prompt for multi-agent orchestration.

curl -X POST https://taskforceai.chat/api/v1/developer/run \
  -H "x-api-key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Analyze the security posture of this repository.",
    "modelId": "moonshotai/kimi-k3",
    "options": { "agentCount": 4 }
  }'

{
  "taskId": "task_abc123",
  "message": "Task submitted successfully"
}

Get Task Status

Check the status of a specific task.

GET /status/{taskId}

Get Task Results

Once a task is completed, retrieve the final output.

GET /results/{taskId}

Files and Threads

Upload files for task context, list uploaded files, download generated artifacts, and work with persistent conversation threads.

GET /files
POST /files
GET /files/{fileId}/content
GET /threads
POST /threads
POST /threads/{threadId}/runs

Models and Usage

Retrieve available AI models and usage details. Model discovery is a platform endpoint outside the Developer API base path; usage stays under /api/v1/developer.

GET https://taskforceai.chat/api/v1/models
GET /usage

OpenAPI

The public OpenAPI spec is served from the docs app at /openapi.yaml during docs builds.

Getting Started

SDKs

Tools

API Reference

Authentication

Base URL

Core Endpoints

Submit a Task

Get Task Status

Get Task Results

Files and Threads

Models and Usage

OpenAPI

​Authentication

​Base URL

​Core Endpoints

​Submit a Task

​Get Task Status

​Get Task Results

​Files and Threads

​Models and Usage

​OpenAPI

Authentication

Base URL

Core Endpoints

Submit a Task

Get Task Status

Get Task Results

Files and Threads

Models and Usage

OpenAPI