ORory
identity

Patch an Identity

Partially updates an identity's field using JSON Patch. The fields id, stateChangedAt and credentials can not be updated using this method.

patch/admin/identities/{id}

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /admin/identities/{id}
  • Auth
    API key in header Authorization

Path parameters

idstring required

ID must be set to the ID of identity you want to update

Request body

fromstring

This field is used together with operation "move" and uses JSON Pointer notation.

Learn more about JSON Pointers.

opstring required

The operation to be performed. One of "add", "remove", "replace", "move", "copy", or "test".

pathstring required

The path to the target path. Uses JSON pointer notation.

Learn more about JSON Pointers.

valuestring

The value to be used within the operations.

Learn more about JSON Pointers.

Example request

[
  {
    "from": "/name",
    "op": "replace",
    "path": "/name",
    "value": "foobar"
  }
]

Response

identity

created_atstring date-time

CreatedAt is a helper struct field for gobuffalo.pop.

credentialsobject

Credentials represents all credentials that can be used for authenticating this identity.

external_idstring

ExternalID is an optional external ID of the identity. This is used to link the identity to an external system. If set, the external ID must be unique across all identities.

idstring uuid required

ID is the identity's unique identifier.

The Identity ID can not be changed and can not be chosen. This ensures future compatibility and optimization for distributed stores such as CockroachDB.

metadata_adminNullJsonRawMessage

NullJSONRawMessage represents a json.RawMessage that works well with JSON, SQL, and Swagger and is NULLable-

metadata_publicNullJsonRawMessage

NullJSONRawMessage represents a json.RawMessage that works well with JSON, SQL, and Swagger and is NULLable-

region'eu-central' | 'asia-northeast' | 'us-east' | 'us-west' | 'eu' | 'asia' | 'us' | 'global'

Region is the Ory Network region this identity is homed in. Set by the multi-region persister; empty on OSS and single-region deployments. eu-central EUCentral asia-northeast AsiaNorthEast us-east USEast us-west USWest eu EU asia Asia us US global Global

schema_idstring required

SchemaID is the ID of the JSON Schema to be used for validating the identity's traits.

schema_urlstring required

SchemaURL is the URL of the endpoint where the identity's traits schema can be fetched from.

format: url

state'active' | 'inactive'

State is the identity's state.

This value has currently no effect. active StateActive inactive StateInactive

state_changed_atstring date-time
traitsIdentityTraits required

Traits represent an identity's traits. The identity is able to create, modify, and delete traits in a self-service manner. The input will always be validated against the JSON Schema defined in schema_url.

updated_atstring date-time

UpdatedAt is a helper struct field for gobuffalo.pop.

Example response

{
  "verifiable_addresses": [
    {
      "created_at": "2014-01-01T23:28:56.782Z",
      "updated_at": "2014-01-01T23:28:56.782Z",
      "verified": true,
      "via": "email"
    }
  ]
}

Changes

No recorded changes to this operation across all 65 revisions of this API.