Get the calling user's context

GET/api/public/v1/users/me/context

The user, the organization the credential is bound to, the user's role there, and whether agent access is on for that organization (mcp_access.enabled; when it is not, reason names the highest level that is off: the site, the organization, or the organization admin). Also the address of the agent docs. An API key reads it like any other credential: the switches describe agent access and never gate the key.

cURL

curl --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/users/me/context' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY"

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/users/me/context',
    method='GET',
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
    },
)
with urllib.request.urlopen(request) as response:
    text = response.read().decode()
    print(json.dumps(json.loads(text), indent=2) if text else response.status)

Bash

#!/usr/bin/env bash
set -euo pipefail

curl -sS --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/users/me/context' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" | jq .

PowerShell

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
Invoke-RestMethod -Method GET -Uri 'https://app.openlatch.ai/api/public/v1/users/me/context' -Headers $headers | ConvertTo-Json -Depth 20

Authorization

Role in the organization	This endpoint
owner	Allowed
admin	Allowed
editor	Allowed
viewer	Allowed

A key carries the role its owner holds in the organization. See Authentication.

API key scope: self

Response

• 200 OK — the call succeeded.
• 401 Unauthorized — UNAUTHORIZED
• 402 Payment Required — license_expired
• 403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
• 404 Not Found — NOT_FOUND
• 422 Unprocessable Content — INVALID_ID, VALIDATION_ERROR
• 429 Too Many Requests — TOO_MANY_REQUESTS
• 500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
• 503 Service Unavailable — FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Response fields

Field	Type	Description
docs_url	string	Required.
mcp_access	object	Required.
mcp_access.enabled	boolean	Required.
mcp_access.reason	string — one of site_off, org_off, org_admin_off or null
organization	object	Required.
organization.id	string	Required.
organization.name	string	Required.
role	string — one of owner, admin, editor, viewer	Required.
user	object	Required.
user.email	string or null
user.id	string	Required.
user.name	string or null

Example response

{
  "docs_url": "https://app.openlatch.ai/",
  "mcp_access": {
    "enabled": false,
    "reason": "site_off"
  },
  "organization": {
    "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
    "name": "release-bot"
  },
  "role": "owner",
  "user": {
    "email": "ada@example.com",
    "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
    "name": "release-bot"
  }
}