EvoHub Docs Sign in

Organization API › Members

List members

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-dev.evohub.io/mcp

Claude Code

claude mcp add --transport http evohub-docs-docs https://docs-dev.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-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs-dev.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

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

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs-docs": {
      "type": "http",
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}
GET/api/v1/users

Every member of the organization, in the order they joined. With permission, only the members who hold that permission (through their standing, a role or a team): the people a picker should offer for a job.

Permission (API-key scope): identity:user:read.

Authorization

Any one of:

Parameters

Query parameters

  • permission string
    A permission from the catalog, for example oncall:alert:respond.
    Example: oncall:alert:respond

Responses

200

The members.

Content type: application/json

Type: object

  • data array of Member required
    Show Member properties
    • 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
  • success boolean required
    Value: true

400

permission is not in the catalog (UNKNOWN_PERMISSION).

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.

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
      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

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

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' \
  -H 'Authorization: Bearer <TOKEN>'

Last updated