Skip to content

List tiers

Use with AI

View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page

Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs.evohub.io/mcp

Add to Cursor Add to VS Code

Claude Code

claude mcp add --transport http evohub-docs https://docs.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs": {
      "url": "https://docs.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs": {
      "type": "http",
      "url": "https://docs.evohub.io/mcp"
    }
  }
}

llms.txt llms-full.txt

GET/api/v1/catalog/tiers

The organization's tiers in use, most critical first, each with the number of services in it. An organization starts with Tier 1 to Tier 4.

Requires the catalog:component:read scope.

Authorization

Any one of:

Parameters

Query parameters

archived string
true to include archived tiers.
Value: true

Responses

`200`

The tiers, most critical first.

Content type: application/json

Type: object

data array of Tier
Show Tier properties
- id string
- name string
  Example: Tier 1
- description string
- rank integer
  Its place in the order, 1 the most critical.
- color string
  Example: #d97706
- targets SLATargets
  Show SLATargets properties
  - availability number
    A percentage above 0 and at most 100, up to 3 decimals.
    Example: 99.9
  - response object
    Minutes to acknowledge, per On-Call severity (critical, high, medium, low, info), 1 to 525600.
    Other keys: integer
  - resolution object
    Minutes to resolve, per severity.
    Other keys: integer
  - support_hours object
    kind string required
    One of: 24x7 business
    timezone string
    Example: Europe/Istanbul
    days array of integer
    ISO weekdays, 1 is Monday.
    from string
    Example: 09:00
    to string
    Example: 18:00
  - max_unowned_days integer
    Minimum: 0 · Maximum: 3650
- version integer
- archived_at string (date-time) | null
- services integer
  How many services are in it.
- created_at string (date-time)
- updated_at string (date-time)

`401`

No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).

Content type: application/json

Type: Error

error object required
- code string required
  Example: NOT_FOUND
- message string required
  Example: not found
- request_id string

`403`

The key lacks a scope this endpoint needs (FORBIDDEN).

Content type: application/json

Type: Error

error object required
- code string required
  Example: NOT_FOUND
- message string required
  Example: not found
- request_id string

`429`

Too many requests (RATE_LIMITED). Wait for Retry-After seconds.

Headers

Retry-After integer
Seconds to wait before retrying.

Content type: application/json

Type: Error

error object required
- code string required
  Example: NOT_FOUND
- message string required
  Example: not found
- request_id string

`500`

Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.

Content type: application/json

Type: Error

error object required
- code string required
  Example: NOT_FOUND
- message string required
  Example: not found
- request_id string

Example request

curl -X GET 'https://evohub.io/api/v1/catalog/tiers' \
  -H 'Authorization: Bearer <TOKEN>'