For Agents
Manage Teamhood boards, rows, items, statuses, attachments, and activity feeds through a v1 REST API authenticated with an X-ApiKey header.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Teamhood API v1, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Teamhood API v1 API.
List, read, and structure boards including their rows and statuses to mirror the Teamhood UI in code
Read and update individual work items on a board including their status and assignment
Attach files to a work item by uploading via /api/v1/attachments and referencing the returned id
Pull the activity history for a board with /api/v1/boards/{boardId}/item-activities for audit and reporting
GET STARTED
Use for: I need to list all boards in my Teamhood workspace, Get the rows and statuses configured on a Teamhood board, Find all items on a board with a specific status, Retrieve the activity history for a board
Not supported: Does not handle billing, user provisioning, or chat messaging — use for Teamhood board, item, attachment, and activity operations only.
Teamhood is a project and task management platform exposing a v1 REST API that covers boards, rows, items, statuses, attachments, and item activity feeds. The 26 operations in this spec let an integration build, query, and update boards programmatically, attach files to work items, and pull activity history for audit and reporting. Authentication is via the X-ApiKey header. The API is rate-limited to 100 requests per minute.
Authenticate requests with the X-ApiKey header per call without a separate token-exchange step
Patterns agents use Teamhood API v1 API for, with concrete tasks.
★ Sync Teamhood Boards with External Tools
Build a one-way or two-way sync between Teamhood and another tool such as a CRM or a code repository by listing boards, walking their rows and items, and reflecting state changes through the items endpoints. The board, row, and status endpoints provide the structural metadata needed to map Teamhood's hierarchy into the external system. Activity feeds give a delta to drive incremental sync.
List boards via /api/v1/boards, then for each board call /api/v1/boards/{boardId}/rows and /api/v1/boards/{boardId}/statuses to build a structural map
Attach Documents to Work Items
Programmatically attach generated reports, screenshots, or contracts to Teamhood items by uploading through /api/v1/attachments and referencing the returned attachment id on the item. The /api/v1/attachments/{id}/content endpoint then lets downstream tools fetch the file when reviewing the item. This is useful when an agent produces an artefact that needs to live alongside a task.
POST a generated PDF to /api/v1/attachments, capture the id, and update the related Teamhood item to reference the attachment id
Activity Audit Trail
Pull recent item activities with /api/v1/boards/{boardId}/item-activities to feed a compliance log, an executive dashboard, or a Slack digest of board changes. The endpoint returns the structured activity feed for the board, which can then be filtered by user, item, or change type before forwarding downstream.
Call /api/v1/boards/{boardId}/item-activities with a recent since-timestamp, filter for status changes, and post a digest to a Slack channel
Agent Integration via Jentic
An AI agent built on Jentic can search for Teamhood board, item, and attachment operations by intent and execute them without holding the X-ApiKey in agent context. Jentic's MAXsystem holds the credential and returns scoped access at call time, which is helpful when an agent automates work across multiple project tools.
Use Jentic search for 'list teamhood boards', load the /api/v1/boards operation, execute it, and pass the returned board ids into a follow-up rows call
26 endpoints — teamhood is a project and task management platform exposing a v1 rest api that covers boards, rows, items, statuses, attachments, and item activity feeds.
METHOD
PATH
DESCRIPTION
/api/v1/boards
List boards in the workspace
/api/v1/boards/{boardId}/rows
List rows on a board
/api/v1/boards/{boardId}/statuses
List the status columns configured on a board
/api/v1/boards/{boardId}/item-activities
Pull the item activity history for a board
/api/v1/items/{itemId}
Read a single work item
/api/v1/attachments
Upload an attachment for linking to an item
/api/v1/attachments/{id}/content
Download an attachment by id
/api/v1/boards
List boards in the workspace
/api/v1/boards/{boardId}/rows
List rows on a board
/api/v1/boards/{boardId}/statuses
List the status columns configured on a board
/api/v1/boards/{boardId}/item-activities
Pull the item activity history for a board
/api/v1/items/{itemId}
Read a single work item
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Teamhood X-ApiKey is stored encrypted in the Jentic vault. Agents receive scoped execution tokens at call time and never hold the raw key, which is helpful for automations that span multiple project tools.
Intent-based discovery
Agents search by intent such as 'list teamhood boards' or 'upload an attachment to a teamhood item' and Jentic returns the matching operation with its full input schema, so the agent can call the right endpoint without browsing the docs.
Time to first call
Direct integration: 1 day to wire auth, board structure traversal, and attachment upload. Through Jentic: under 1 hour from search to first executed call.
Alternatives and complements available in the Jentic catalogue.
Teamhood API
The teamhood.com listing of the same v1 surface
Prefer the teamhood.com listing for the canonical vendor URL; use this listing when your tooling already references the api-sxkan host
Asana API
Task and project management API with rich workspace, project, and task models
Choose Asana when the team uses Asana as their primary project tool; choose Teamhood when Teamhood is the system of record
Trello API
Kanban-board API with cards, lists, and boards
Choose Trello when the team works in Trello boards rather than Teamhood
monday.com API
Work-OS API with boards, items, and updates
Choose monday.com when the team's process is built around monday.com boards
ClickUp API
Productivity platform API covering tasks, lists, and spaces
Choose ClickUp when the team works in ClickUp's hierarchy rather than Teamhood boards
Specific to using Teamhood API v1 API through Jentic.
What authentication does the Teamhood API use?
Teamhood requires an API key passed as the X-ApiKey header. Through Jentic the key is held in the Jentic vault and a scoped execution token is granted at call time, so the agent never holds the raw key.
Can I attach files to Teamhood items via the API?
Yes. POST a file to /api/v1/attachments, capture the returned attachment id, and reference it on the related item. Use GET /api/v1/attachments/{id}/content to retrieve the file when reviewing the item later.
What are the rate limits for the Teamhood API?
Teamhood limits requests to 100 per minute per API key. Stay within that ceiling, batch reads where possible, and respect any 429 responses with exponential backoff.
How do I list a workspace's boards through Jentic?
Install the Jentic SDK with pip install jentic, search for 'list teamhood boards', load the GET /api/v1/boards operation, and execute it. Sign up at https://app.jentic.com/sign-up to get a Jentic agent key.
Can I get the activity history for a board?
Yes. GET /api/v1/boards/{boardId}/item-activities returns the item activity feed for a board, which you can filter by since-timestamp or user to produce digests, audit logs, or change notifications.
/api/v1/attachments
Upload an attachment for linking to an item
/api/v1/attachments/{id}/content
Download an attachment by id