Rebind a machine client to a new client ID

POST

/api/machine-clients/{id}/rebind

Maintainer:Not configured

OperationId:admin_rebind_machine_client

Points a fresh IdP client_id at the agent profile an existing machine client holds; by default the old client is revoked in the same transaction. The path {id} names the source client. Requires a system admin.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The new machine client, bound to the inherited profile

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/machine-clients//rebind' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "client_id": "string",
    "from_machine_client_id": "dda12dfe-2979-4c52-92ce-c307c03c5c65",
    "keep_old_active": true,
    "label": "string"
}'

Response Example

200 - Example 1

{
    "client_id": "string",
    "created": "2019-08-24T14:15:22.123Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "issuer": "string",
    "label": "string",
    "last_seen_at": "2019-08-24T14:15:22.123Z",
    "profile_id": "bfcb6779-b1f9-41fc-92d7-88f8bc1d12e8",
    "registered_by_profile_id": "18e6908a-ccb7-48bf-a180-a379e0568e01",
    "revoked_at": "2019-08-24T14:15:22.123Z",
    "revoked_by_profile_id": "e2512452-9e5c-40a6-8117-21bb43a829e4",
    "team_id": "810007d0-bec5-486c-b5d1-28fcd8a079ba"
}

Modified at 2026-10-06 12:32:37

Re-embed stale chunks

Request to join the gating team