Register an external agent identity.

POST

/api/v4/projects/{id}/ai_agent/identities

• GitLab REST API

Registers a new agent identity for the current user, project, agent type, and machine fingerprint combination. Returns an existing record if one already exists. Returns 403 if the identity has been revoked.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project

Example

1

Request Body^required

Media typeapplication/json

object

agent_type

required

The type of agent being registered.

string

>= 1 characters

Allowed values: claude-code opencode

machine_fingerprint

required

SHA-256 hash of the machine identifier.

string

nullable <= 64 characters

Responses

201

Created

Media typeapplication/json

object

id

integer

agent_type

string

revoked_at

string

created_at

string

Example

{
  "id": 1,
  "agent_type": "claude-code",
  "created_at": "2026-06-17T00:00:00.000Z"
}

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found