v4

latestOpenAPI 3.0.22026-07-3188146256.6 KB

Entities

restoreEntity

Restores an entity by id

Activity

If no activity_id query parameter is provided, implicitly creates Activity of type EntityRestore

patch/v1/entity/{slug}/{id}:restore

Path parameters

idstring uuid required

Entity id

slugstring required

URL-friendly identifier for the entity schema

Example:contact

Entity Type

Query parameters

string ulid

See https://github.com/ulid/spec

'' | 'null' nullable

Example:01F130Q52Q6MWSNS8N2AVXV4JN

Activity to include in event feed

Request body

object required

This endpoint doesn't require a payload, but an empty object can be sent to satisfy certain HTTP clients.

Response

The restored entity

_idstring uuid required

_orgstring required

Organization Id the entity belongs to

_schemastring required

URL-friendly identifier for the entity schema

_titlestring nullable required

Title of entity

_tagsstring[] nullable

_created_atstring date-time nullable required

_updated_atstring date-time nullable required

_deleted_atstring date-time nullable

_purposestring[] nullable

_purpose_namestring[] nullable

Automatically computed purpose names from _purpose attribute

_manifeststring[] nullable

Manifest ID used to create/update the entity

_changesetsobject nullable

Pending attribute changesets for attributes configured with external or approval edit mode.

The value shape is Changeset (proposed_value, created_at, edit_mode, ...) and is what :apply / :dismiss operate on.

Read-only via normal entity PATCH/PUT operations — those handlers strip _changesets from request bodies. Use the changeset management endpoints to mutate this field.

Example response

{
  "_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "_org": "123",
  "_owners": [
    {
      "org_id": "123",
      "user_id": "123"
    }
  ],
  "_schema": "contact",
  "_tags": [
    "example",
    "mock"
  ],
  "_created_at": "2021-02-09T12:41:43.662Z",
  "_updated_at": "2021-02-09T12:41:43.662Z",
  "_acl": {
    "view": [
      "org:456",
      "org:789"
    ],
    "edit": [
      "org:456"
    ],
    "delete": [
      "org:456"
    ]
  },
  "_manifest": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}