Directory

The Directory API gives you access to Organizations, Accounts, Employees and Groups. Every Entity within the subsequent API calls must have an Organization attached and API calls must be made with a User specific JWT.

List organizations

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization

GET /api/v1/organization HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "alias": "text",
    "owners": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "profile": {
      "logoUrl": "text",
      "timezone": "text",
      "location": "text",
      "countryCode": "text",
      "companySize": "text",
      "website": "text",
      "mission": "text"
    },
    "apps": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "externalId": "text",
        "internal": true,
        "name": "text",
        "type": "text",
        "active": true,
        "status": {
          "current": "ACTIVE",
          "changedAt": "2026-01-30T10:18:58.224Z",
          "changedBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "created": {
          "createdAt": "2026-01-30T10:18:58.224Z",
          "createdBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "organization": "123e4567-e89b-12d3-a456-426614174000",
        "secretData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "appData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "keys": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "secretBase64": "text",
        "limitToRole": "text"
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

Create organization

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringRequired

aliasstringOptional

ownerEmailstringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/organization

POST /api/v1/organization HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "name": "text",
  "alias": "text",
  "ownerEmail": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Update current organization

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringRequired

aliasstringOptional

ownerEmailstringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/organization

PATCH /api/v1/organization HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "name": "text",
  "alias": "text",
  "ownerEmail": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Get organization by ID

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization/{organization}

GET /api/v1/organization/{organization} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Update organization by ID

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationstringRequired

Body

namestringRequired

aliasstringOptional

ownerEmailstringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/organization/{organization}

PATCH /api/v1/organization/{organization} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 50

{
  "name": "text",
  "alias": "text",
  "ownerEmail": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Get organization profile

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization/profile

GET /api/v1/organization/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "logoUrl": "text",
  "timezone": "text",
  "location": "text",
  "countryCode": "text",
  "companySize": "text",
  "website": "text",
  "mission": "text"
}

Create or replace organization profile

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

logoUrlstringOptional

timezonestringOptional

locationstringOptional

countryCodestringOptional

companySizestringOptional

websitestringOptional

missionstringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/organization/profile

POST /api/v1/organization/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "logoUrl": "text",
  "timezone": "text",
  "location": "text",
  "countryCode": "text",
  "companySize": "text",
  "website": "text",
  "mission": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Update organization profile

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

logoUrlstringOptional

timezonestringOptional

locationstringOptional

countryCodestringOptional

companySizestringOptional

websitestringOptional

missionstringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/organization/profile

PATCH /api/v1/organization/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "logoUrl": "text",
  "timezone": "text",
  "location": "text",
  "countryCode": "text",
  "companySize": "text",
  "website": "text",
  "mission": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Get organization profile by ID

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization/{organization}/profile

GET /api/v1/organization/{organization}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "logoUrl": "text",
  "timezone": "text",
  "location": "text",
  "countryCode": "text",
  "companySize": "text",
  "website": "text",
  "mission": "text"
}

Create or replace profile for organization

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationstringRequired

Body

logoUrlstringOptional

timezonestringOptional

locationstringOptional

countryCodestringOptional

companySizestringOptional

websitestringOptional

missionstringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/organization/{organization}/profile

POST /api/v1/organization/{organization}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "logoUrl": "text",
  "timezone": "text",
  "location": "text",
  "countryCode": "text",
  "companySize": "text",
  "website": "text",
  "mission": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Update profile for organization

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationstringRequired

Body

logoUrlstringOptional

timezonestringOptional

locationstringOptional

countryCodestringOptional

companySizestringOptional

websitestringOptional

missionstringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/organization/{organization}/profile

PATCH /api/v1/organization/{organization}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 130

{
  "logoUrl": "text",
  "timezone": "text",
  "location": "text",
  "countryCode": "text",
  "companySize": "text",
  "website": "text",
  "mission": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Get organization by alias

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

aliasstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization/alias/{alias}

GET /api/v1/organization/alias/{alias} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

List organizations by app type

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

typestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization/by-app/{type}

GET /api/v1/organization/by-app/{type} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "alias": "text",
    "owners": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "profile": {
      "logoUrl": "text",
      "timezone": "text",
      "location": "text",
      "countryCode": "text",
      "companySize": "text",
      "website": "text",
      "mission": "text"
    },
    "apps": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "externalId": "text",
        "internal": true,
        "name": "text",
        "type": "text",
        "active": true,
        "status": {
          "current": "ACTIVE",
          "changedAt": "2026-01-30T10:18:58.224Z",
          "changedBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "created": {
          "createdAt": "2026-01-30T10:18:58.224Z",
          "createdBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "organization": "123e4567-e89b-12d3-a456-426614174000",
        "secretData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "appData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "keys": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "secretBase64": "text",
        "limitToRole": "text"
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

List organizations by app external ID

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

typestringRequired

externalIdstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization/by-app-id/{type}/{externalId}

GET /api/v1/organization/by-app-id/{type}/{externalId} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "alias": "text",
    "owners": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "profile": {
      "logoUrl": "text",
      "timezone": "text",
      "location": "text",
      "countryCode": "text",
      "companySize": "text",
      "website": "text",
      "mission": "text"
    },
    "apps": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "externalId": "text",
        "internal": true,
        "name": "text",
        "type": "text",
        "active": true,
        "status": {
          "current": "ACTIVE",
          "changedAt": "2026-01-30T10:18:58.224Z",
          "changedBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "created": {
          "createdAt": "2026-01-30T10:18:58.224Z",
          "createdBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "organization": "123e4567-e89b-12d3-a456-426614174000",
        "secretData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "appData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "keys": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "secretBase64": "text",
        "limitToRole": "text"
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

List organizations by app data

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

typestringRequired

keystringRequired

valuestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/organization/by-app-data/{type}/{key}/{value}

GET /api/v1/organization/by-app-data/{type}/{key}/{value} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "alias": "text",
    "owners": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "profile": {
      "logoUrl": "text",
      "timezone": "text",
      "location": "text",
      "countryCode": "text",
      "companySize": "text",
      "website": "text",
      "mission": "text"
    },
    "apps": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "externalId": "text",
        "internal": true,
        "name": "text",
        "type": "text",
        "active": true,
        "status": {
          "current": "ACTIVE",
          "changedAt": "2026-01-30T10:18:58.224Z",
          "changedBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "created": {
          "createdAt": "2026-01-30T10:18:58.224Z",
          "createdBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "organization": "123e4567-e89b-12d3-a456-426614174000",
        "secretData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "appData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "keys": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "secretBase64": "text",
        "limitToRole": "text"
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

List organizations by app secret

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

typestringRequired

keystringRequired

Body

secretstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/organization/by-app-secret/{type}/{key}

POST /api/v1/organization/by-app-secret/{type}/{key} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "secret": "text"
}

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "alias": "text",
    "owners": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "profile": {
      "logoUrl": "text",
      "timezone": "text",
      "location": "text",
      "countryCode": "text",
      "companySize": "text",
      "website": "text",
      "mission": "text"
    },
    "apps": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "externalId": "text",
        "internal": true,
        "name": "text",
        "type": "text",
        "active": true,
        "status": {
          "current": "ACTIVE",
          "changedAt": "2026-01-30T10:18:58.224Z",
          "changedBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "created": {
          "createdAt": "2026-01-30T10:18:58.224Z",
          "createdBy": "123e4567-e89b-12d3-a456-426614174000"
        },
        "organization": "123e4567-e89b-12d3-a456-426614174000",
        "secretData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "appData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "keys": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "secretBase64": "text",
        "limitToRole": "text"
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

Create API key for organization

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringRequired

limitToRolestringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/organization/keys

POST /api/v1/organization/keys HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "limitToRole": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Create API key for org by ID

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationstringRequired

Body

namestringRequired

limitToRolestringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/organization/{organization}/keys

POST /api/v1/organization/{organization}/keys HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "limitToRole": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Delete API key for current organization

delete

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

keystringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

delete

/api/v1/organization/keys/{key}

DELETE /api/v1/organization/keys/{key} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Delete API key by org ID

delete

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationstringRequired

keystringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

delete

/api/v1/organization/{organization}/keys/{key}

DELETE /api/v1/organization/{organization}/keys/{key} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "alias": "text",
  "owners": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "profile": {
    "logoUrl": "text",
    "timezone": "text",
    "location": "text",
    "countryCode": "text",
    "companySize": "text",
    "website": "text",
    "mission": "text"
  },
  "apps": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "externalId": "text",
      "internal": true,
      "name": "text",
      "type": "text",
      "active": true,
      "status": {
        "current": "ACTIVE",
        "changedAt": "2026-01-30T10:18:58.224Z",
        "changedBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "created": {
        "createdAt": "2026-01-30T10:18:58.224Z",
        "createdBy": "123e4567-e89b-12d3-a456-426614174000"
      },
      "organization": "123e4567-e89b-12d3-a456-426614174000",
      "secretData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "appData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "keys": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "secretBase64": "text",
      "limitToRole": "text"
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

List accounts

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/account

GET /api/v1/account HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "email": "text",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "grants": [
      {
        "orgId": "123e4567-e89b-12d3-a456-426614174000",
        "role": "text",
        "employeeId": "123e4567-e89b-12d3-a456-426614174000"
      }
    ]
  }
]

Create account

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringOptional

emailstringRequired

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/account

POST /api/v1/account HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "name": "text",
  "email": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "grants": [
    {
      "orgId": "123e4567-e89b-12d3-a456-426614174000",
      "role": "text",
      "employeeId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Get account by ID or email

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdOrEmailstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/account/{accountIdOrEmail}

GET /api/v1/account/{accountIdOrEmail} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "grants": [
    {
      "orgId": "123e4567-e89b-12d3-a456-426614174000",
      "role": "text",
      "employeeId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Update account

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdOrEmailstringRequired

Body

namestringOptional

emailstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/account/{accountIdOrEmail}

PATCH /api/v1/account/{accountIdOrEmail} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "name": "text",
  "email": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "grants": [
    {
      "orgId": "123e4567-e89b-12d3-a456-426614174000",
      "role": "text",
      "employeeId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

Grant account a role

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstringRequired

Body

orgIdstring · uuidOptional

rolestringRequired

employeeIdstring · uuidOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/account/{accountId}/grant

POST /api/v1/account/{accountId}/grant HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "orgId": "123e4567-e89b-12d3-a456-426614174000",
  "role": "text",
  "employeeId": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "email": "text",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "grants": [
    {
      "orgId": "123e4567-e89b-12d3-a456-426614174000",
      "role": "text",
      "employeeId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

List organization admins

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/account/org-admins

GET /api/v1/account/org-admins HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "email": "text",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "grants": [
      {
        "orgId": "123e4567-e89b-12d3-a456-426614174000",
        "role": "text",
        "employeeId": "123e4567-e89b-12d3-a456-426614174000"
      }
    ]
  }
]

List employees for account

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/account/{accountId}/employees

GET /api/v1/account/{accountId}/employees HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "emails": [
      {
        "email": "text",
        "primary": true
      }
    ],
    "groups": [
      {
        "entityType": "text",
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text"
      }
    ],
    "managers": [
      {
        "managerId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text",
        "since": "2026-01-30T10:18:58.224Z"
      }
    ],
    "profile": {
      "employeeNumber": "text",
      "firstName": "text",
      "lastName": "text",
      "bio": "text",
      "profileImage": "text",
      "birthDate": "2026-01-30",
      "gender": "text",
      "timezone": "text",
      "location": "text",
      "joinDate": "2026-01-30",
      "companyRole": "text"
    },
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "authentication": {
      "account": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2026-01-30T10:18:58.224Z",
      "email": "text",
      "role": "text"
    },
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

List accounts for organization

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/account/for-org

GET /api/v1/account/for-org HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "email": "text",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "grants": [
      {
        "orgId": "123e4567-e89b-12d3-a456-426614174000",
        "role": "text",
        "employeeId": "123e4567-e89b-12d3-a456-426614174000"
      }
    ]
  }
]

List employees

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

statusstringOptional

typestringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/employee

GET /api/v1/employee HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "emails": [
      {
        "email": "text",
        "primary": true
      }
    ],
    "groups": [
      {
        "entityType": "text",
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text"
      }
    ],
    "managers": [
      {
        "managerId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text",
        "since": "2026-01-30T10:18:58.224Z"
      }
    ],
    "profile": {
      "employeeNumber": "text",
      "firstName": "text",
      "lastName": "text",
      "bio": "text",
      "profileImage": "text",
      "birthDate": "2026-01-30",
      "gender": "text",
      "timezone": "text",
      "location": "text",
      "joinDate": "2026-01-30",
      "companyRole": "text"
    },
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "authentication": {
      "account": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2026-01-30T10:18:58.224Z",
      "email": "text",
      "role": "text"
    },
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

Create employee

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringRequired

emailstringRequired

accountstring · uuidOptional

rolestringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/employee

POST /api/v1/employee HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "name": "text",
  "email": "text",
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "role": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "emails": [
    {
      "email": "text",
      "primary": true
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "managers": [
    {
      "managerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ],
  "profile": {
    "employeeNumber": "text",
    "firstName": "text",
    "lastName": "text",
    "bio": "text",
    "profileImage": "text",
    "birthDate": "2026-01-30",
    "gender": "text",
    "timezone": "text",
    "location": "text",
    "joinDate": "2026-01-30",
    "companyRole": "text"
  },
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "authentication": {
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-30T10:18:58.224Z",
    "email": "text",
    "role": "text"
  },
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Get employee

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/employee/{employee}

GET /api/v1/employee/{employee} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "emails": [
    {
      "email": "text",
      "primary": true
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "managers": [
    {
      "managerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ],
  "profile": {
    "employeeNumber": "text",
    "firstName": "text",
    "lastName": "text",
    "bio": "text",
    "profileImage": "text",
    "birthDate": "2026-01-30",
    "gender": "text",
    "timezone": "text",
    "location": "text",
    "joinDate": "2026-01-30",
    "companyRole": "text"
  },
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "authentication": {
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-30T10:18:58.224Z",
    "email": "text",
    "role": "text"
  },
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Update employee

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

Body

namestringRequired

emailstringRequired

accountstring · uuidOptional

rolestringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/employee/{employee}

PATCH /api/v1/employee/{employee} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "name": "text",
  "email": "text",
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "role": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "emails": [
    {
      "email": "text",
      "primary": true
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "managers": [
    {
      "managerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ],
  "profile": {
    "employeeNumber": "text",
    "firstName": "text",
    "lastName": "text",
    "bio": "text",
    "profileImage": "text",
    "birthDate": "2026-01-30",
    "gender": "text",
    "timezone": "text",
    "location": "text",
    "joinDate": "2026-01-30",
    "companyRole": "text"
  },
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "authentication": {
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-30T10:18:58.224Z",
    "email": "text",
    "role": "text"
  },
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Get employees by name

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

namestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/employee/by-name/{name}

GET /api/v1/employee/by-name/{name} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "emails": [
      {
        "email": "text",
        "primary": true
      }
    ],
    "groups": [
      {
        "entityType": "text",
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text"
      }
    ],
    "managers": [
      {
        "managerId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text",
        "since": "2026-01-30T10:18:58.224Z"
      }
    ],
    "profile": {
      "employeeNumber": "text",
      "firstName": "text",
      "lastName": "text",
      "bio": "text",
      "profileImage": "text",
      "birthDate": "2026-01-30",
      "gender": "text",
      "timezone": "text",
      "location": "text",
      "joinDate": "2026-01-30",
      "companyRole": "text"
    },
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "authentication": {
      "account": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2026-01-30T10:18:58.224Z",
      "email": "text",
      "role": "text"
    },
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

List managers of employee

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/employee/{employee}/managers

GET /api/v1/employee/{employee}/managers HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "managerId": "123e4567-e89b-12d3-a456-426614174000",
    "type": "text",
    "since": "2026-01-30T10:18:58.224Z"
  }
]

Set managers for employee

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

Body

managerIdstring · uuidRequired

typestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/employee/{employee}/managers

POST /api/v1/employee/{employee}/managers HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

{
  "managerId": "123e4567-e89b-12d3-a456-426614174000",
  "type": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "emails": [
    {
      "email": "text",
      "primary": true
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "managers": [
    {
      "managerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ],
  "profile": {
    "employeeNumber": "text",
    "firstName": "text",
    "lastName": "text",
    "bio": "text",
    "profileImage": "text",
    "birthDate": "2026-01-30",
    "gender": "text",
    "timezone": "text",
    "location": "text",
    "joinDate": "2026-01-30",
    "companyRole": "text"
  },
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "authentication": {
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-30T10:18:58.224Z",
    "email": "text",
    "role": "text"
  },
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Remove manager from employee

delete

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

managerstringRequired

Responses

200

No content

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

delete

/api/v1/employee/{employee}/managers/{manager}

DELETE /api/v1/employee/{employee}/managers/{manager} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get employee profile

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/employee/{employee}/profile

GET /api/v1/employee/{employee}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "employeeNumber": "text",
  "firstName": "text",
  "lastName": "text",
  "bio": "text",
  "profileImage": "text",
  "birthDate": "2026-01-30",
  "gender": "text",
  "timezone": "text",
  "location": "text",
  "joinDate": "2026-01-30",
  "companyRole": "text"
}

Create or replace employee profile

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

Body

employeeNumberstringOptional

firstNamestringOptional

lastNamestringOptional

biostringOptional

profileImagestringOptional

birthDatestring · dateOptional

genderstringOptional

timezonestringOptional

locationstringOptional

joinDatestring · dateOptional

companyRolestringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/employee/{employee}/profile

POST /api/v1/employee/{employee}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 219

{
  "employeeNumber": "text",
  "firstName": "text",
  "lastName": "text",
  "bio": "text",
  "profileImage": "text",
  "birthDate": "2026-01-30",
  "gender": "text",
  "timezone": "text",
  "location": "text",
  "joinDate": "2026-01-30",
  "companyRole": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "emails": [
    {
      "email": "text",
      "primary": true
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "managers": [
    {
      "managerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ],
  "profile": {
    "employeeNumber": "text",
    "firstName": "text",
    "lastName": "text",
    "bio": "text",
    "profileImage": "text",
    "birthDate": "2026-01-30",
    "gender": "text",
    "timezone": "text",
    "location": "text",
    "joinDate": "2026-01-30",
    "companyRole": "text"
  },
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "authentication": {
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-30T10:18:58.224Z",
    "email": "text",
    "role": "text"
  },
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Update employee profile

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

employeestringRequired

Body

employeeNumberstringOptional

firstNamestringOptional

lastNamestringOptional

biostringOptional

profileImagestringOptional

birthDatestring · dateOptional

genderstringOptional

timezonestringOptional

locationstringOptional

joinDatestring · dateOptional

companyRolestringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/employee/{employee}/profile

PATCH /api/v1/employee/{employee}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 219

{
  "employeeNumber": "text",
  "firstName": "text",
  "lastName": "text",
  "bio": "text",
  "profileImage": "text",
  "birthDate": "2026-01-30",
  "gender": "text",
  "timezone": "text",
  "location": "text",
  "joinDate": "2026-01-30",
  "companyRole": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "emails": [
    {
      "email": "text",
      "primary": true
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "managers": [
    {
      "managerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ],
  "profile": {
    "employeeNumber": "text",
    "firstName": "text",
    "lastName": "text",
    "bio": "text",
    "profileImage": "text",
    "birthDate": "2026-01-30",
    "gender": "text",
    "timezone": "text",
    "location": "text",
    "joinDate": "2026-01-30",
    "companyRole": "text"
  },
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "authentication": {
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-30T10:18:58.224Z",
    "email": "text",
    "role": "text"
  },
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

Get employee by account ID

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

accountIdstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/employee/by-account/{accountId}

GET /api/v1/employee/by-account/{accountId} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "emails": [
    {
      "email": "text",
      "primary": true
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "managers": [
    {
      "managerId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ],
  "profile": {
    "employeeNumber": "text",
    "firstName": "text",
    "lastName": "text",
    "bio": "text",
    "profileImage": "text",
    "birthDate": "2026-01-30",
    "gender": "text",
    "timezone": "text",
    "location": "text",
    "joinDate": "2026-01-30",
    "companyRole": "text"
  },
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "authentication": {
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "createdAt": "2026-01-30T10:18:58.224Z",
    "email": "text",
    "role": "text"
  },
  "preferences": {
    "namespace": "text",
    "values": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ]
}

List reports for manager

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

managerIdstringRequired

Query parameters

typestringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/employee/by-manager/{managerId}

GET /api/v1/employee/by-manager/{managerId} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "emails": [
      {
        "email": "text",
        "primary": true
      }
    ],
    "groups": [
      {
        "entityType": "text",
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text"
      }
    ],
    "managers": [
      {
        "managerId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text",
        "since": "2026-01-30T10:18:58.224Z"
      }
    ],
    "profile": {
      "employeeNumber": "text",
      "firstName": "text",
      "lastName": "text",
      "bio": "text",
      "profileImage": "text",
      "birthDate": "2026-01-30",
      "gender": "text",
      "timezone": "text",
      "location": "text",
      "joinDate": "2026-01-30",
      "companyRole": "text"
    },
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "authentication": {
      "account": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2026-01-30T10:18:58.224Z",
      "email": "text",
      "role": "text"
    },
    "preferences": {
      "namespace": "text",
      "values": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  }
]

List groups

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

statusstringOptional

typestringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/group

GET /api/v1/group HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "type": "text",
    "organization": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "active": true,
    "status": {
      "current": "text",
      "changedAt": "2026-01-30T10:18:58.224Z",
      "changedBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "created": {
      "createdAt": "2026-01-30T10:18:58.224Z",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000"
    },
    "profile": {
      "icon": "text",
      "description": "text"
    },
    "mappings": [
      {
        "app": "123e4567-e89b-12d3-a456-426614174000",
        "namespace": "text",
        "mappedId": "text",
        "reference": "text",
        "mappingData": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "mappingSecrets": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ],
    "groups": [
      {
        "entityType": "text",
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text"
      }
    ],
    "members": [
      {
        "entityType": "text",
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "type": "text",
        "since": "2026-01-30T10:18:58.224Z"
      }
    ]
  }
]

Create group

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringRequired

typestringRequired

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/group

POST /api/v1/group HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "name": "text",
  "type": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "text",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "profile": {
    "icon": "text",
    "description": "text"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "members": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ]
}

Get group

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/group/{id}

GET /api/v1/group/{id} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "text",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "profile": {
    "icon": "text",
    "description": "text"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "members": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ]
}

Update group

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Body

namestringRequired

typestringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/group/{id}

PATCH /api/v1/group/{id} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "name": "text",
  "type": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "text",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "profile": {
    "icon": "text",
    "description": "text"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "members": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ]
}

Get group profile

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupstringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/group/{group}/profile

GET /api/v1/group/{group}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "icon": "text",
  "description": "text"
}

Create or replace group profile

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupstringRequired

Body

iconstringOptional

descriptionstringOptional

Responses

201

Created

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/group/{group}/profile

POST /api/v1/group/{group}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "icon": "text",
  "description": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "text",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "profile": {
    "icon": "text",
    "description": "text"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "members": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ]
}

Update group profile

patch

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupstringRequired

Body

iconstringOptional

descriptionstringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

patch

/api/v1/group/{group}/profile

PATCH /api/v1/group/{group}/profile HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "icon": "text",
  "description": "text"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "type": "text",
  "organization": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "active": true,
  "status": {
    "current": "text",
    "changedAt": "2026-01-30T10:18:58.224Z",
    "changedBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "created": {
    "createdAt": "2026-01-30T10:18:58.224Z",
    "createdBy": "123e4567-e89b-12d3-a456-426614174000"
  },
  "profile": {
    "icon": "text",
    "description": "text"
  },
  "mappings": [
    {
      "app": "123e4567-e89b-12d3-a456-426614174000",
      "namespace": "text",
      "mappedId": "text",
      "reference": "text",
      "mappingData": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "mappingSecrets": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      }
    }
  ],
  "groups": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text"
    }
  ],
  "members": [
    {
      "entityType": "text",
      "entityId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "text",
      "since": "2026-01-30T10:18:58.224Z"
    }
  ]
}

List group members

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

groupIdstringRequired

Query parameters

entitystringOptional

membershipstringOptional

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/group/{groupId}/members

GET /api/v1/group/{groupId}/members HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "entityId": "123e4567-e89b-12d3-a456-426614174000",
    "type": "text",
    "organization": "123e4567-e89b-12d3-a456-426614174000"
  }
]

Get entity groups

get

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

entitystringRequired

Responses

200

application/json

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

get

/api/v1/entity/{entity}/groups

GET /api/v1/entity/{entity}/groups HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "entityType": "text",
    "entityId": "123e4567-e89b-12d3-a456-426614174000",
    "type": "text"
  }
]

Set groups for entity

post

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

entitystringRequired

Bodyobject[]

groupIdstring · uuidOptional

typestringOptional

Responses

200

No content

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

post

/api/v1/entity/{entity}/groups

POST /api/v1/entity/{entity}/groups HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 66

[
  {
    "groupId": "123e4567-e89b-12d3-a456-426614174000",
    "type": "text"
  }
]

No content

Remove entity from group

delete

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

entitystringRequired

groupstringRequired

Responses

200

No content

400

Bad Request – invalid request payload.

401

Unauthorized – missing or invalid JWT.

403

Forbidden – insufficient permissions.

404

Not Found – no Entity with that ID.

delete

/api/v1/entity/{entity}/groups/{group}

DELETE /api/v1/entity/{entity}/groups/{group} HTTP/1.1
Host: api.peoplelogic.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

PreviousSync Frequency NextOKRs (or Goals)

Last updated 6 months ago

Was this helpful?

hashtagList organizations

hashtagCreate organization

hashtagUpdate current organization

hashtagGet organization by ID

hashtagUpdate organization by ID

hashtagGet organization profile

hashtagCreate or replace organization profile

hashtagUpdate organization profile

hashtagGet organization profile by ID

hashtagCreate or replace profile for organization

hashtagUpdate profile for organization

hashtagGet organization by alias

hashtagList organizations by app type

hashtagList organizations by app external ID

hashtagList organizations by app data

hashtagList organizations by app secret

hashtagCreate API key for organization

hashtagCreate API key for org by ID

hashtagDelete API key for current organization

hashtagDelete API key by org ID

hashtagList accounts

hashtagCreate account

hashtagGet account by ID or email

hashtagUpdate account

hashtagGrant account a role

hashtagList organization admins

hashtagList employees for account

hashtagList accounts for organization

hashtagList employees

hashtagCreate employee

hashtagGet employee

hashtagUpdate employee

hashtagGet employees by name

hashtagList managers of employee

hashtagSet managers for employee

hashtagRemove manager from employee

hashtagGet employee profile

hashtagCreate or replace employee profile

hashtagUpdate employee profile

hashtagGet employee by account ID

hashtagList reports for manager

hashtagList groups

hashtagCreate group

hashtagGet group

hashtagUpdate group

hashtagGet group profile

hashtagCreate or replace group profile

hashtagUpdate group profile

hashtagList group members

hashtagGet entity groups

hashtagSet groups for entity

hashtagRemove entity from group

List organizations

Create organization

Update current organization

Get organization by ID

Update organization by ID

Get organization profile

Create or replace organization profile

Update organization profile

Get organization profile by ID

Create or replace profile for organization

Update profile for organization

Get organization by alias

List organizations by app type

List organizations by app external ID

List organizations by app data

List organizations by app secret

Create API key for organization

Create API key for org by ID

Delete API key for current organization

Delete API key by org ID

List accounts

Create account

Get account by ID or email

Update account

Grant account a role

List organization admins

List employees for account

List accounts for organization

List employees

Create employee

Get employee

Update employee

Get employees by name

List managers of employee

Set managers for employee

Remove manager from employee

Get employee profile

Create or replace employee profile

Update employee profile

Get employee by account ID

List reports for manager

List groups

Create group

Get group

Update group

Get group profile

Create or replace group profile

Update group profile

List group members

Get entity groups

Set groups for entity

Remove entity from group