Who am I
Return the key, organization, scopes, and access for the current request.
Request
GET /v1/self
Shows this key, its organization and what it can do.
Requires an active API key or AI connection.
MCP action: get_self. Its argument names match the fields below; an HTTP header is passed using its argument name in MCP.
No request parameters are needed.
Response
| HTTP status | Result |
|---|---|
200 |
The key that sent this request. |
Required fields are required within their containing object. Notes identify fields that apply only to a particular response alternative.
| Response field | Type | Required in object | Notes |
|---|---|---|---|
data |
Self | Yes | |
data.object |
"self" |
Yes | |
data.api_key |
object | Yes | |
data.api_key.id |
string (uuid) | Yes | |
data.api_key.object |
"api_key" |
Yes | |
data.api_key.name |
string | Yes | |
data.api_key.created_at |
string (date-time) | Yes | |
data.api_key.secret |
object | Yes | |
data.api_key.secret.id |
string (uuid) | Yes | |
data.api_key.secret.object |
"api_key_secret" |
Yes | |
data.api_key.secret.last_four |
string | Yes | |
data.api_key.secret.created_at |
string (date-time) | Yes | |
data.api_key.secret.expires_at |
string (date-time) | Yes | |
data.organization |
object | Yes | |
data.organization.id |
string | Yes | |
data.organization.object |
"organization" |
Yes | |
data.organization.name |
string | Yes | |
data.scopes |
array of string | Yes | |
data.access |
object | Yes | |
data.access.deduplication |
object | No | |
data.access.deduplication.grants |
array of object | Yes | |
data.access.deduplication.grants[].id |
string (uuid) | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].version |
string | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].provider_workspace_id |
string | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].connection_id |
string (uuid) or null | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].object_type |
string | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].target_id |
string or null | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].expires_at |
string (date-time) | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].kind |
"dedupe_access" |
Yes | When data.access.deduplication.grants[].kind is "dedupe_access". |
data.access.deduplication.grants[].terms |
object | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". When data.access.deduplication.grants[].kind is "dedupe_merge". When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].terms.full_object_scan |
boolean | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". |
data.access.deduplication.grants[].terms.ai_evidence |
boolean | Yes | When data.access.deduplication.grants[].kind is "dedupe_access". Default: false. |
data.access.deduplication.grants[].kind |
"dedupe_merge" |
Yes | When data.access.deduplication.grants[].kind is "dedupe_merge". |
data.access.deduplication.grants[].terms.merge_all_fields |
true |
Yes | When data.access.deduplication.grants[].kind is "dedupe_merge". |
data.access.deduplication.grants[].terms.allowed_recovery_omissions |
array of "list_entries", "comments", "notes", "tasks", "files", "meetings", "call_recordings", "incoming_references" |
Yes | When data.access.deduplication.grants[].kind is "dedupe_merge". |
data.access.deduplication.grants[].kind |
"scheduled_runs_all" |
Yes | When data.access.deduplication.grants[].kind is "scheduled_runs_all". |
data.access.deduplication.grants[].terms.history_sources |
"own", "all" |
Yes | When data.access.deduplication.grants[].kind is "scheduled_runs_all". When data.access.deduplication.grants[].kind is "scheduled_runs_target". Default: "own". |
data.access.deduplication.grants[].kind |
"scheduled_runs_target" |
Yes | When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].terms.workflow_id |
string | Yes | When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].terms.entry_point_id |
string | Yes | When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].terms.kind |
"scheduled" |
Yes | When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.deduplication.grants[].terms.target_revision |
string | Yes | When data.access.deduplication.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs |
object | No | |
data.access.scheduled_runs.grants |
array of object | Yes | |
data.access.scheduled_runs.grants[].id |
string (uuid) | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].version |
string | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].provider_workspace_id |
string | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].connection_id |
string (uuid) or null | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].object_type |
string | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].target_id |
string or null | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].expires_at |
string (date-time) | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].kind |
"dedupe_access" |
Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". |
data.access.scheduled_runs.grants[].terms |
object | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". When data.access.scheduled_runs.grants[].kind is "dedupe_merge". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].terms.full_object_scan |
boolean | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". |
data.access.scheduled_runs.grants[].terms.ai_evidence |
boolean | Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_access". Default: false. |
data.access.scheduled_runs.grants[].kind |
"dedupe_merge" |
Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_merge". |
data.access.scheduled_runs.grants[].terms.merge_all_fields |
true |
Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_merge". |
data.access.scheduled_runs.grants[].terms.allowed_recovery_omissions |
array of "list_entries", "comments", "notes", "tasks", "files", "meetings", "call_recordings", "incoming_references" |
Yes | When data.access.scheduled_runs.grants[].kind is "dedupe_merge". |
data.access.scheduled_runs.grants[].kind |
"scheduled_runs_all" |
Yes | When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". |
data.access.scheduled_runs.grants[].terms.history_sources |
"own", "all" |
Yes | When data.access.scheduled_runs.grants[].kind is "scheduled_runs_all". When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". Default: "own". |
data.access.scheduled_runs.grants[].kind |
"scheduled_runs_target" |
Yes | When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].terms.workflow_id |
string | Yes | When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].terms.entry_point_id |
string | Yes | When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].terms.kind |
"scheduled" |
Yes | When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.scheduled_runs.grants[].terms.target_revision |
string | Yes | When data.access.scheduled_runs.grants[].kind is "scheduled_runs_target". |
data.access.lookup_tables |
object | No | |
data.access.lookup_tables.table_access |
"all", "selected" |
Yes | |
data.access.lookup_tables.readable_table_count |
integer | Yes |
Errors
| HTTP status | Meaning |
|---|---|
400 |
One of: invalid_request, invalid_filter, invalid_value, invalid_cursor, credential_in_url. |
401 |
One of: missing_credential, invalid_credential, credential_expired, credential_revoked. |
402 |
One of: payment_overdue. |
403 |
One of: plan_required, not_available, insufficient_scope, operation_not_allowed, field_not_writable, plan_capacity_exceeded. |
404 |
One of: resource_not_found. |
409 |
One of: table_filling, table_fill_failed, lookup_key_required, key_conflict, version_conflict, table_busy, table_capacity_exceeded, idempotency_conflict. |
413 |
One of: request_too_large. |
422 |
One of: batch_rejected. |
423 |
One of: organization_reopening. |
428 |
One of: customer_agreement_required. |
429 |
One of: rate_limited. |
503 |
One of: service_unavailable. |
See errors and recovery and safe retries before repeating a write.
The public OpenAPI document lists generally available API families. Alpha operations may not appear in that document; their request and response fields are listed on this page. Use the API Playground to inspect a real response with your connection's access.