# Who am I Source: https://neondeerdata.com/docs/api/meta/self/ Return the key, organization, scopes, and access for the current request. ## Request ```http 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](https://neondeerdata.com/docs/api/errors/) and [safe retries](https://neondeerdata.com/docs/api/requests/) before repeating a write. The [public OpenAPI document](https://neondeerdata.com/docs/api/meta/openapi/) 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](https://neondeerdata.com/docs/api/testing/) to inspect a real response with your connection's access.