API overview

The Tryno API follows RESTful conventions. All requests and responses use JSON, and every endpoint requires authentication via Bearer Token.

Base URL

All API requests are made to the following base URL:

https://api.tryno.io/v1

Every request must include a valid Bearer Token in the Authorization header:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.tryno.io/v1/communities

You can generate your API key at Admin > Settings > API. See the Authentication page for details on login, token refresh, and session management.

Rate limits depend on your plan. If you exceed the limit, the API returns a 429 status code.

Plan	Limit
Pro	100 req/min
Business	1,000 req/min

Rate-limited responses include X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers so you can adjust your request cadence.

All successful responses follow a consistent envelope:

{
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 100
  }
}

When a request fails, the API returns a structured error object:

{
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "Community not found",
    "status": 404
  }
}

HTTP status codes

Common error codes

Error code	Meaning
`VALIDATION_ERROR`	One or more request body fields are invalid.
`RESOURCE_NOT_FOUND`	The requested resource does not exist.
`UNAUTHORIZED`	The Bearer Token is missing or invalid.
`FORBIDDEN`	You do not have permission to perform this action.
`RATE_LIMIT_EXCEEDED`	You have exceeded the request rate limit for your plan.

List endpoints support cursor-based pagination through query parameters:

GET /v1/communities?page=2&per_page=20

Parameter	Type	Default	Description
`page`	int	1	The page number to retrieve.
`per_page`	int	20	Items per page (max 50).

Official SDKs are coming soon for:

In the meantime, you can interact with the API directly using any HTTP client such as curl, Postman, or your language’s built-in HTTP library.