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

Autorisation

Rôle dans l’organisation	Ce point de terminaison
owner	Autorisé
admin	Autorisé
editor	Autorisé
viewer	Autorisé

Une clé porte le rôle que son propriétaire détient dans l’organisation. Voir Authentification.

Portée de clé d’API : self

Réponse

• 200 OK — l’appel a réussi.
• 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

Champs de la réponse

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

Exemple de réponse

{
  "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"
  }
}