# Taskfolk Agents API

**Canonical:** https://apis.io/apis/taskfolk/taskfolk-agents-api/  
**Provider:** Taskfolk — https://apis.io/providers/taskfolk/  
**Base URL:** https://taskfolk.ai/api  
**Documentation:** https://taskfolk.ai/api/v1/reference

Taskfolk Agents API is one of 32 APIs that [Taskfolk](https://apis.io/providers/taskfolk/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

The Agents API from Taskfolk — 5 operation(s) for agents.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/workspaces/{slug}/agents` | List the workspace's connected agents (named coding agents like Claude Code, Codex, Cursor). Assign issues to an agent's agent_id like any member. |
| GET | `/v1/workspaces/{slug}/agents/{id}` | Get one agent's full profile: identity, owner, key state + scopes, field policy, spend cap, and cost + token totals. {id} is the agent_id. |
| GET | `/v1/workspaces/{slug}/agent-sessions` | List agent work sessions, newest activity first. Filter by state to see which agents are running, blocked (needs_input), or ready for review. |
| POST | `/v1/workspaces/{slug}/agent-sessions` | Start an agent work session. Call this when you pick up an issue so the team can follow your progress on the ticket and the Agents hub. |
| GET | `/v1/workspaces/{slug}/agent-sessions/{id}` | Get one agent session. |
| PATCH | `/v1/workspaces/{slug}/agent-sessions/{id}` | Update your session: heartbeat (any PATCH bumps last_activity_at), progress note, state change (needs_input when blocked, review when the PR is ready, done/f... |
| POST | `/v1/workspaces/{slug}/agent-sessions/{id}/usage` | Report your token usage / cost for this session (one call per turn, additive). Send cost_usd from your provider, or send tokens + model and Taskfolk estimate... |

## Machine-readable artifacts (16)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/openapi/taskfolk-agents-api-openapi.yml
- **Documentation** — https://taskfolk.ai/api/v1/reference
- **APIReference** — https://taskfolk.ai/api/v1/reference
- **DeveloperPortal** — https://taskfolk.ai/developer
- **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/mcp/taskfolk-tool-crosswalk.yml
- **AgentCard** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/a2a/taskfolk-a2a.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/authentication/taskfolk-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/scopes/taskfolk-scopes.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/asyncapi/taskfolk-webhooks.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/errors/taskfolk-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conventions/taskfolk-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conventions/taskfolk-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/rate-limits/taskfolk-rate-limits.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/data-model/taskfolk-data-model.yml
- **Plans** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/plans/taskfolk-plans-pricing.yml
- **Conformance** — https://raw.githubusercontent.com/api-evangelist/taskfolk/refs/heads/main/conformance/taskfolk-conformance.yml

## Other Taskfolk APIs (12)

- [Taskfolk Activity API](https://apis.io/apis/taskfolk/taskfolk-activity-api/)
- [Taskfolk Attachments API](https://apis.io/apis/taskfolk/taskfolk-attachments-api/)
- [Taskfolk Automations API](https://apis.io/apis/taskfolk/taskfolk-automations-api/)
- [Taskfolk Chat API](https://apis.io/apis/taskfolk/taskfolk-chat-api/)
- [Taskfolk Comments API](https://apis.io/apis/taskfolk/taskfolk-comments-api/)
- [Taskfolk Custom fields API](https://apis.io/apis/taskfolk/taskfolk-custom-fields-api/)
- [Taskfolk Developer API](https://apis.io/apis/taskfolk/taskfolk-developer-api/)
- [Taskfolk Docs API](https://apis.io/apis/taskfolk/taskfolk-docs-api/)
- [Taskfolk Forms API](https://apis.io/apis/taskfolk/taskfolk-forms-api/)
- [Taskfolk Goals API](https://apis.io/apis/taskfolk/taskfolk-goals-api/)
- [Taskfolk Issues API](https://apis.io/apis/taskfolk/taskfolk-issues-api/)
- [Taskfolk Key results API](https://apis.io/apis/taskfolk/taskfolk-key-results-api/)

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/taskfolk/taskfolk-agents-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/taskfolk/.