Browse docs
Getting Started
Channels
Tickets
AI
Workflows
Teams
Reports
Integrations

API and Agent Skill

Beyond the web UI

The There There web interface is where most support work happens, but it is not the only way to interact with your helpdesk. The REST API and the agent skill let you manage tickets, reply to customers, and automate support tasks from outside the browser.

This is especially powerful when combined with AI. You can build custom integrations that create and manage tickets programmatically, or let AI coding agents handle routine support tasks on your behalf.

The REST API

There There provides a REST API that gives you programmatic access to your workspace. You can create tickets, send replies, manage tags and assignments, look up contacts, and more.

The API uses bearer token authentication. Each workspace member can generate a personal access token in Settings > API Tokens. Include the token in the Authorization header of your requests.

Authorization: Bearer your-token-here

The base URL for all API requests is https://app.therethere.com/api. A full OpenAPI 3.1 specification is available at /docs/api-reference for exploring endpoints interactively.

For complete documentation of every endpoint, request format, and response structure, see the API documentation.

What you can do with the API

  • Create tickets from external sources (web forms, chat widgets, internal tools).
  • Reply, forward, and add notes to existing tickets.
  • Update ticket status and assignment to integrate with your existing workflows.
  • Manage tags on tickets for automated categorization.
  • Search contacts and view their ticket history.
  • List channels and members for building custom dashboards or routing logic.

Common integration patterns

Incoming tickets from a web form: POST to /api/tickets with the customer's email, subject, and message body. The ticket appears in your inbox immediately.

Status sync with a project tracker: When a related issue is resolved in your project tracker, use the API to close the corresponding ticket in There There and add an internal note with the resolution details.

Daily reports: GET /api/tickets with status and date filters to generate daily ticket volume reports or SLA tracking dashboards.

The CLI

The There There CLI is a command-line tool that wraps the API into simple commands you can run from your terminal. Install it with Composer:

composer global require spatie/there-there-cli
there-there login

Once logged in, you can list tickets, send replies, manage assignments, and more without leaving your terminal. The CLI supports JSON and YAML output, making it easy to pipe results into other tools.

For the full command reference, see Using the CLI.

The agent skill

Agent skills are instruction files that teach AI coding agents (like Claude Code, Cursor, or Codex) how to use the CLI. When installed, your AI coding agent can manage your helpdesk tickets, reply to customers, and organize your support workflow through natural language commands.

Installation

Make sure the CLI is installed and you are logged in, then add the skill to your project:

npx skills add spatie/there-there-cli

This adds a skill file to your project that compatible AI agents automatically pick up.

What the agent can do

Once the skill is installed, you can ask your AI coding agent things like:

  • "Show me all open tickets assigned to me"
  • "Reply to the latest ticket from john@example.com explaining that the fix is deployed"
  • "Close all resolved tickets from this week"
  • "Triage unassigned tickets and assign them to the right team members"
  • "Add the 'billing' tag to all tickets with 'invoice' in the subject"

The agent uses the CLI under the hood, so it has access to everything the CLI can do: listing tickets, replying, forwarding, adding notes, managing tags and assignments, and searching contacts.

Daily support routine

One powerful pattern is to ask your agent to run through a daily support routine. For example: "Go through all unassigned open tickets. For each one, check the subject and first message, then assign it to the right team member based on the topic." The agent will work through the tickets one by one, making decisions based on the context it reads.

For more details on the agent skill, see Agent Skill.