ThinkForce Skill

Dispatch tasks to your ThinkForce AI agent team at app.thinkforce.ai and poll for results — all via the REST API. No server setup needed.

Getting Your API Key

1. Go to app.thinkforce.ai and sign up / log in.
2. Open Settings → ThinkForce API.
3. Click + Generate API Key — copy and save it.

Use your key as the X-TF-API-Key header on every request.

Quick Start

Step 1 — Get Your Company ID

Your API key automatically identifies your company:

GET https://app.thinkforce.ai/api/companies
X-TF-API-Key: tf_your_key_here

Response:

{
  "companyId": "your-company-id",
  "name": "Acme Corp",
  "status": "active",
  "agentCount": 4
}

Step 2 — List Your Agents

POST https://app.thinkforce.ai/api/agents
X-TF-API-Key: tf_your_key_here
Content-Type: application/json

{ "action": "list", "companyId": "your-company-id" }

Response:

[
  { "id": "abc123", "agentName": "Acme CEO", "agentRole": "CEO" },
  { "id": "def456", "agentName": "Dev", "agentRole": "Developer" }
]

Step 3 — Dispatch a Task

POST https://app.thinkforce.ai/api/agent-task
X-TF-API-Key: tf_your_key_here
Content-Type: application/json

{
  "companyID": "your-company-id",
  "targetAgentId": "abc123",
  "task": "Research the top 5 competitor apps and summarize their pricing."
}

Response:

{
  "taskId": "task-1773947855985-abc12",
  "status": "running"
}

Step 4 — Poll for Result

GET https://app.thinkforce.ai/api/agent-task?taskId=<taskId>&companyId=<companyId>
X-TF-API-Key: tf_your_key_here

Poll every 5–8 seconds. Most tasks complete in 15–90 seconds.

Completed response:

{
  "taskId": "task-1773947855985-abc12",
  "status": "complete",
  "result": "Here are the top 5 competitors..."
}

Full JavaScript Example

const API_KEY = 'tf_your_key_here';
const BASE = 'https://app.thinkforce.ai/api';

// 1. Get company
const co = await fetch(`${BASE}/companies`, {
  headers: { 'X-TF-API-Key': API_KEY }
}).then(r => r.json());

const companyID = co.companyId;

// 2. List agents to find the CEO
const agents = await fetch(`${BASE}/agents`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-TF-API-Key': API_KEY },
  body: JSON.stringify({ action: 'list', companyId: companyID }),
}).then(r => r.json());

const ceo = agents.find(a => a.agentRole === 'CEO');

// 3. Dispatch task
const { taskId } = await fetch(`${BASE}/agent-task`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', 'X-TF-API-Key': API_KEY },
  body: JSON.stringify({
    companyID,
    targetAgentId: ceo.id,
    task: 'Write a 30-day growth plan.',
  }),
}).then(r => r.json());