> ## Documentation Index > Fetch the complete documentation index at: https://docs.rootkey.ai/llms.txt > Use this file to discover all available pages before exploring further. # Restore a deleted record > Brings a deleted record back. Returns 200 with an empty body. If the record's table is itself deleted, the request is refused with `table_also_deleted`: restore the table in the ROOTKey app first, then the record. With a personal access token it needs the `rootkey.delete` scope (a restore undoes a delete), an organization role that may restore records and an organization that lets agents write; a record of a RESTRICTED table is never restored by an agent. Agents can restore records but never delete one. ## OpenAPI ````yaml patch /records/{recordId}/restore openapi: 3.0.3 info: title: ROOTKey Documentation description: >- Your API of choice for creating, managing, and validating information easily and securely! termsOfService: https://www.rootkey.ai/legal/privacy-policy contact: name: ROOTKey url: https://www.rootkey.ai/contact email: support@rootkey.ai version: 1.0.0 servers: - description: Production url: https://api.rootkey.ai/api-v1/ security: - x-api-key: [] - personalAccessToken: [] tags: - name: api-v1-public description: Unauthenticated top-level /api-v1 endpoints (health, plans, annual report) - name: api-v1-files description: >- File anchoring, versioning, validation and compliance reporting (/api-v1/platform/files) - name: api-v1-records description: Structured-data record anchoring (/api-v1/platform/records) - name: api-v1-vaults description: >- Vault lifecycle: create / update / delete / restore (/api-v1/platform/vaults, /api-v1/vaults) - name: api-v1-recovery-points description: >- Backup archives created from vault contents (/api-v1/platform/recovery-point) - name: api-v1-organizations description: >- The identity of a personal access token and the organizations it can act in (/api-v1/me, /api-v1/organizations, /api-v1/organization) - name: api-v1-agents description: >- What an agent asks the person it acts for: access to RESTRICTED data for a short time (/api-v1/agent-step-ups) paths: /records/{recordId}/restore: patch: tags: - api-v1-records summary: Restore a deleted record description: >- Brings a deleted record back. Returns 200 with an empty body. If the record's table is itself deleted, the request is refused with `table_also_deleted`: restore the table in the ROOTKey app first, then the record. With a personal access token it needs the `rootkey.delete` scope (a restore undoes a delete), an organization role that may restore records and an organization that lets agents write; a record of a RESTRICTED table is never restored by an agent. Agents can restore records but never delete one. parameters: - $ref: '#/components/parameters/OrganizationHeader' - $ref: '#/components/parameters/TestModeHeader' - name: recordId in: path required: true schema: type: string - name: ownerAddress in: query required: true schema: type: string description: The table the record belongs to. responses: '200': description: Record restored '400': description: >- The record is not deleted (`record_not_deleted`), its table is deleted (`table_also_deleted`), or the address is not valid (`invalid_wallet_address`). content: application/json: schema: $ref: '#/components/schemas/DomainErrorResponse' '401': description: >- Unauthenticated. A missing, malformed, unknown, inactive, revoked or expired credential all get the same answer. '403': description: >- The table does not own this record (`invalid_ownership`). A personal access token can also be refused by the organization: see the [Errors](/api-reference/errors) page. content: application/json: schema: $ref: '#/components/schemas/DomainErrorResponse' '404': description: No such table or record (`resource_not_found`). content: application/json: schema: $ref: '#/components/schemas/DomainErrorResponse' '410': description: >- The retention policy already removed the record for good (`record_already_purged`). content: application/json: schema: $ref: '#/components/schemas/DomainErrorResponse' '429': description: >- Too many requests for the Restore Center. The `Retry-After` header says how many seconds to wait. See [Rate Limits](/pages/rate-limits). '500': $ref: '#/components/responses/InternalError' security: - x-api-key: [] - personalAccessToken: [] components: parameters: OrganizationHeader: name: X-RootKey-Organization in: header required: false schema: type: string description: >- The organization a personal access token acts in: the `id` of one of the organizations that `GET /organizations` lists. Required with a personal access token on every endpoint that works inside an organization; without it the request gets `organization_header_required`. Ignored with an API key, which belongs to exactly one organization. TestModeHeader: name: x-test-mode in: header required: false schema: type: string enum: - 'true' - 'false' default: 'false' description: >- Whether a personal access token works on live data (`false`, the default) or on test data (`true`). Only this header decides, never a query string or a body field. An API key is itself a test or a live key and works on that data. schemas: DomainErrorResponse: type: object properties: error: type: object properties: requestId: type: string message: type: string errorCode: type: string docUrl: type: string timestamp: type: string format: date-time responses: InternalError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/DomainErrorResponse' securitySchemes: x-api-key: type: apiKey name: x-api-key in: header description: >- ROOTKey API key. A test key works on your organization's test data and a live key on its live data; both are used with the same API. personalAccessToken: type: http scheme: bearer bearerFormat: rk_pat_... description: >- Personal access token of a ROOTKey user, sent as `Authorization: Bearer rk_pat_...`. A token acts as the user who created it, in the organization named by the `X-RootKey-Organization` header, and never with more access than that user has in the ROOTKey app: the organization's agent policy, the user's own role and teams, and the token's scopes (`rootkey.read`, `rootkey.write`, `rootkey.delete`) all apply. A missing, malformed, unknown, revoked or expired token gets the same `401`. Send either an `x-api-key` or a bearer token, never both: a request with both gets `conflicting_credentials`. See [Authentication](/api-reference/auth). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.