No results

Register an identity

Register a new identity.

POST https://api.jsonpad.io/identities/register

Example

cURL
12345678910curl https://api.jsonpad.io/identities/register \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>" \
  -H "x-identity-token: <IDENTITY TOKEN>" \
  -H "x-identity-group: <IDENTITY GROUP>" \
  -d '{
        "name": "My New Identity",
        "group": "sample-group",
        "password": "secret",
      }'

Parameters

No parameters

Request headers

  • required
    x-api-tokenstringYour API token.
  • optional
    x-identity-tokenstringAn identity token.
  • optional
    x-identity-groupstringAn identity group.

Request body

{
group: "sample-group"
name: "Sample Identity"
password: "secret"
}
  • optional
    groupstringThe identity's group. This can be used to associate identities with a particular app or project, and helps to avoid name conflicts.
  • optional
    namestringThe name of the identity.
  • optional
    passwordstring

    The identity's password.

Response body

200 OK
{
id: "517daa74-30e5-4065-a07d-5f7f32a2ee6e"
createdAt: "2026-09-05T11:30:38.254Z"
updatedAt: "2026-09-05T11:30:38.254Z"
user: {
id: "487031ed-efb6-4565-9d8b-1006bd9432b2"
createdAt: "2026-09-05T11:30:38.254Z"
updatedAt: "2026-09-05T11:30:38.254Z"
lastActiveAt: "2026-09-05T11:30:38.254Z"
activated: true
displayName: "Sample User"
description: "Sample user description"
}
name: "Sample Identity"
group: "sample-group"
activated: true
}

Response headers

  • locationhttps://api.jsonpad.io/identities/e6bbb5bf-86e6-47a0-84df-6fe18aae75d6The URL of the newly created identity.
  • last-modified2026-09-05T11:30:38.254ZThe date this identity was last modified.
2024-10-29