EvoHub DocsEvoHub Docs Sign in

Who the key belongs to

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 CursorAdd 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.txtllms-full.txt

GET/api/v1/users/me

The person a personal key belongs to, in the key's organization, with roles and permissions. roles is what the key acts with (org:member for every key); permissions is worked out for the person, so it lists what the person holds, not the key's scopes.

An organization key belongs to no person: it gets 403 NOT_A_PERSON, which is a working key, not a bad one.

Permission: none — any valid API key of the organization.

Authorization

Any one of:

Responses

200

The key's person.

Content type: application/json

Type: object

  • data Member & object required
    • id string required
    • email string (email) required
    • name string required
    • title string
    • role Standing required
      One of: owner admin member viewer
    • org_id string required
    • status string required
      One of: active invited suspended
    • mfa_enabled boolean
    • mfa_setup_required boolean
      Only on /users/me: the login policy requires MFA and the person has not set it up.
    • has_password boolean
      false for people who sign in only with GitHub or Google.
    • phone_number string
    • phone_verified boolean
    • created_at string (date-time) required
    • updated_at string (date-time) required
    • roles array of string
    • permissions array of string
    • teams array of object
      The teams the person is in.
      • id string
      • name string
      • slug string
  • success boolean required
    Value: true

401

The key is not valid (UNAUTHORIZED), or its person's account no longer exists.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.
    • request_id string
      The response's X-Request-ID; quote it to support.

403

An organization key (NOT_A_PERSON).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.
    • request_id string
      The response's X-Request-ID; quote it to support.

429

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

Headers

  • Retry-After integer
    Seconds to wait.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.
    • request_id string
      The response's X-Request-ID; quote it to support.

500

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

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.
    • request_id string
      The response's X-Request-ID; quote it to support.

Example request

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