Welcome to the Thena API reference documentation. Our API suite is organized into three main sections, each serving a distinct purpose in the Thena ecosystem.
All APIs require authentication using an x-api-key header. API keys are tied to individual users and can be generated from Dashboard → Organization Settings → Security and Access.

Platform APIs

Core infrastructure services including authentication, SLA management, workflow orchestration, ticketing, accounts, teams, tags, forms, comments, and more.

App Platform APIs

Create, manage, and distribute custom applications within the Thena ecosystem. Includes app creation, installation, uninstallation, and webhook handling.

Workflows APIs

Automate business processes and orchestrate workflows across the Thena platform. Includes workflow creation, execution, event handling, and activity/task management.
Remember to check our rate limits and implement appropriate error handling in your applications. For production deployments, consider implementing retry logic with exponential backoff.

​
API overview

The Platform APIs form the core of Thena’s infrastructure:
  • Core services: Authentication, health checks, and storage management.
  • SLA management: Create and manage SLA policies, monitor SLA compliance.
  • Workflow orchestration: Define, execute, and monitor automated workflows.
  • Ticket management: Comprehensive ticket lifecycle management.
  • Accounts, teams, tags, forms, comments, and more: Manage all aspects of your organization.
Platform APIs are designed for system-level integrations and core service management.

​
Getting started

1

Choose your API

Select the appropriate API section based on your use case:
  • Platform APIs for core infrastructure and organization management.
  • App Platform APIs for custom applications and integrations.
  • Workflows APIs for automation and workflow orchestration.
2

Authentication

Generate an API key from your Thena Dashboard:
  • Go to Organization Settings → Security and Access.
  • Click Generate API Key and copy your key securely.
  • Include your API key in all requests using the x-api-key header.

curl -X GET https://platform.thena.ai/v1/users \
  -H "x-api-key: YOUR_API_KEY"
3

Explore endpoints

Browse the API reference for your chosen section:
  • Review request/response formats.
  • Check required parameters.
  • Test example requests.
4

Integration

Start integrating with your application:
  • Follow best practices.
  • Monitor rate limits.
  • Handle errors appropriately.

​
Rate limiting

All API requests are subject to rate limiting to ensure fair usage and platform stability. Rate limit information is provided in the response headers for every request:
HeaderDescription
X-RateLimit-LimitThe maximum number of requests allowed in the current window.
X-RateLimit-RemainingThe number of requests remaining in the current window.
X-RateLimit-ResetThe UNIX timestamp (seconds) when the rate limit window resets.
X-RateLimit-IPThe IP address associated with the request.
X-RateLimit-UserIDThe user ID associated with the request (if available).
X-RateLimit-OrgIDThe organization ID associated with the request (if available).
X-RateLimit-PathThe API path for which the rate limit applies.
Default rate limit:
  • Standard tier: 60 requests per minute per user, org, and IP (unless otherwise specified).
  • Enterprise tier: Custom limits based on your plan.
You can monitor your current usage and remaining quota by inspecting these headers in each API response. If you exceed your rate limit, you will receive a 429 Too Many Requests error. Wait until the reset time before making additional requests.