Skip to main content
POST
Create a machine identity

Authorizations

Authorization
string
header
required

A personal access token (POST /v1/auth/tokens) or a machine identity token (POST /v1/projects/{project_id}/identities/{identity_id}/tokens), both prefixed qumo_pat_. A token's scopes cap what it can do; see Scopes and permissions. A personal token names no organization: on a route whose path names no project or organization, pass ?organization_id=.

Path Parameters

project_id
string<uuid>
required

The project's id.

Body

application/json
name
string
required

Display name.

Example:

"ci-deployer"

Response

The created identity.

A machine identity in a project.

id
string<uuid>
required
Example:

"c2a4e6f8-0b1d-4c3e-9f5a-7b9d1e3f5a6c"

project_id
string<uuid>
required
Example:

"9b1d6e2f-4a3c-4f8b-a7e5-0c9d2b4f6e81"

name
string
required
Example:

"ci-deployer"

owner_user_id
string<uuid>
required

The user who created the identity.

Example:

"5e7a9c3b-1d2f-4b6e-8a0c-7f3d9e1b5a24"

created_at
string<date-time>
required
Example:

"2026-10-14T09:12:44Z"