Teamwork × AI · REST

Talk to your Teamwork
projects in plain language.

Relay is an AI wrapper around the Teamwork API. Send your Teamwork authorization token in the Authorization header and query projects, tasks, and milestones — no scraping, no glue code.

How to authorize → GET /projects.php
Getting started

How to authorize

Every request to Relay must carry a valid Teamwork token. Requests without one are rejected with 401 Unauthorized.

01

Grab your Teamwork token

In Teamwork, open your avatar → Edit My Details → API & Mobile, and copy your API key (or generate a personal access token). This is your Teamwork authorization token.

02

Send it in the Authorization header

Attach the token to every request using the Authorization: Bearer scheme. Relay verifies it before forwarding anything to Teamwork.

# required on every request Authorization: Bearer YOUR_TEAMWORK_TOKEN
03

Call an endpoint

You're connected. Hit /projects.php to list your projects through the AI layer.

curl https://teamwork.mtmsdev.com/projects.php \ -H "Authorization: Bearer YOUR_TEAMWORK_TOKEN"
401

No token, or a malformed header, returns 401 Unauthorized. If you land on that page, come back here — the full connection instructions live on this page.

Reference

The projects endpoint

A single protected route. Authorize, and Relay returns your Teamwork projects as JSON.

REQUEST

GET/projects.php
Header  Authorization: Bearer <token>
Accept  application/json
Auth    Teamwork token (required)

RESPONSE · 200 OK

{ "status": 200, "authorized": true, "source": "teamwork", "projects": [ … ] }