canonical: https://jentic.com/apis/tookan.com/tookan

# Tookan API

Tookan is a delivery management and logistics platform. The API provides access to tasks, agents, customers, and delivery operations. The API exposes 11 endpoints secured with apiKey authentication.

## For AI agents

Programmatically create task, get task details. Covers 11 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for productivity only.

## Capabilities

- Create Task
- Get Task Details
- List Tasks
- Update Task
- Delete Task

## Use cases

### Productivity Operations

Use the Tookan API to perform productivity operations programmatically. The API provides 11 endpoints covering core functionality including create task, get task details, list tasks.

Example prompt: Call POST /create_task to create task

### Automated Tasks Management

Automate tasks operations by combining multiple Tookan API endpoints. Agents can get task details and then list tasks in a single workflow.

Example prompt: Call POST /get_task_details to get task details, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Tookan API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'create task', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /create_task | Create Task |
| POST | /get_task_details | Get Task Details |
| POST | /get_job_list | List Tasks |
| POST | /update_task | Update Task |
| POST | /delete_task | Delete Task |
| POST | /add_agent | Create Agent |
| POST | /view_all_agents | List Agents |
| POST | /edit_agent | Update Agent |

## Key resources

- **Tasks** — Delivery task management
- **Agents** — Delivery agent management
- **Customers** — Customer management

## Why Jentic

- **Setup:** Wiring Tookan by hand means passing its api_key in the request body of every call, tracking the api.tookanapp.com v2 host, and coding your own request and error handling for task and agent management. Through Jentic you install once, import the Tookan API from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Tookan carries the task and agent target in the request body rather than the URL path, so scope the agent to the operations it needs, such as creating a task or fetching task details. You choose which operations are allowed, so destructive ones like deleting a task are left out unless you add them.
- **Credential handling:** Your Tookan API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a task' or 'get the job list', and Jentic returns the matching Tookan operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Asana** — Alternative productivity API
- **Monday** — Alternative productivity API
- **Clickup** — Complementary productivity API

## FAQ

### What authentication does the Tookan API use?

The Tookan API uses an API key passed in the `api_key` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I create task with the Tookan API?

Yes. Use the POST /create_task endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Tookan API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I create task through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'create task'. Jentic returns the matching Tookan API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Tookan API have?

The Tookan API exposes 11 endpoints covering tasks, agents, customers operations.

### Can I limit what my agent is allowed to do with the Tookan API?

Yes. Because you run Jentic One yourself and set its rules, you decide which Tookan operations your agent may call, so you can allow read and create actions like get task details and create task while withholding destructive ones like delete task. Tookan carries the task or agent target in the request body rather than the URL path, so you scope access at the operation level, granting only the endpoints the agent needs. The Tookan API key is stored once by your own instance and injected at execution time, and any operation you have not allowed simply cannot be invoked.