NeoKaam API
A REST API for automations and AI agents. Authenticate with an API key as a bearer token: a personal key from your Profile page (it reaches your projects outside any organization), or an organization key from an organization's admin console:
curl -H "Authorization: Bearer nk_live_EXAMPLE..." \
https://neokaam.com/api/meThe machine-readable contract is at /api/openapi.json.
Endpoints
| Method | Path | Scope | Summary |
|---|---|---|---|
| GET | /api/me | read | Identify the calling principal, its organization and its scopes. |
| GET | /api/projects | read | List the projects this principal can see. |
| POST | /api/projects | project.create | Create a project owned by the calling principal. |
| GET | /api/tasks | read | List tasks, filtered by project, assignee, status or update time. |
| POST | /api/tasks | task.create | Create a task. |
| GET | /api/tasks/{taskId} | read | Read one task with its assignees, labels and counts. |
| PUT | /api/tasks/{taskId} | task.edit | Update a task's fields, assignees or labels. |
| DELETE | /api/tasks/{taskId} | task.delete | Delete a task. |
| POST | /api/tasks/{taskId}/complete | task.edit | Toggle a task's completion. |
| GET | /api/tasks/{taskId}/comments | read | List a task's comments. |
| POST | /api/tasks/{taskId}/comments | task.comment | Comment on a task. |
| GET | /api/tasks/{taskId}/subtasks | read | List a task's subtasks (its checklist), in order. |
| POST | /api/tasks/{taskId}/subtasks | task.edit | Add a subtask to the end of a task's checklist. |
| PUT | /api/subtasks/{subtaskId} | task.edit | Rename, reorder or tick a subtask. |
| GET | /api/tasks/{taskId}/attachments | attachment.read | List a task's attachments. |
| GET | /api/attachments/{attachmentId} | attachment.read | Get a short-lived signed download URL for one attachment. |
| GET | /api/projects/{projectId}/members | read | List a project's members and their roles. |
| GET | /api/orgs/{orgId}/members | read | List an organization's members. |
| GET | /api/orgs/{orgId}/events | read | Poll the organization's event feed, cursored by event id. |