Ir al contenido
Aymar Agents

Get Me

Ver como Markdown
GET
/public/v1/me
curl --request GET \
  --url https://api.aymaragents.com/public/v1/me \
  --header 'X-API-Key: <X-API-Key>'

Return the caller’s tenant id, key prefix, EFFECTIVE scopes, plan and rate-limit ceiling.

rateLimit (API-3 verification, D-API-2) is the REAL per-plan ceiling this SAME request was just checked against inside require_public_api_caller (public_api_plan_limits, pro/enterprise/uso_libre – never a placeholder or a hardcoded constant): it is exactly what X-RateLimit-Limit on THIS response already carries, restated in the body for a caller that only reads JSON. A plan downgrade between two calls changes it on the very next request, same as every other gate in require_public_api_caller.

Permiso necesario: ninguno (además de una clave válida y con plan Pro o Enterprise)

Authorizations

Sección titulada «Authorizations»

Responses

Sección titulada «Responses»

200

Sección titulada «200»

Successful Response

Media typeapplication/json
PublicMeOut

GET /public/v1/me – caller introspection.

Feeds the future MCP-propio (D-API-10, MCP-SERVER-1): it filters which tools it exposes by this SAME scopes/plan pair, never a separate resolution mechanism. scopes is the caller’s EFFECTIVE, already-narrowed set (key scopes intersected with the owner’s api_key-medium grant, PA-5) – never the key’s raw sealed scopes alone.

object
tenantId
required
Tenantid
string
keyPrefix
required
Keyprefix
string
scopes
required
Scopes
Array<string>
plan
required
Plan
string
rateLimit
required
PublicRateLimitOut

The caller’s own plan-tiered /public/v1 rate-limit ceiling (D-API-2).

object
perMinute
required
Perminute
integer
perDay
required
Perday
integer

Examplegenerated

{
  "tenantId": "example",
  "keyPrefix": "example",
  "scopes": [
    "example"
  ],
  "plan": "example",
  "rateLimit": {
    "perMinute": 1,
    "perDay": 1
  }
}