リファレンスHTTP APIAgents

Unbind a credential name from an agent

DELETE
/v1/agents/{id}/credential-bindings/{binding_id}

Takes what binding takes. The next session of a release naming it, and the next message to a running one, is refused 409 CREDENTIAL_UNBOUND with a failed receipt; a running session's remote MCP calls are refused from the next exchange and an open one is cut within 30 seconds, while a call already sent finishes. The answer's binding.running_sessions and revoke_notice say so. Writes an unbind_credential receipt; a binding already revoked is not found.

Auth: cookie session only; no scope. Idempotency-Key: ignored.

Authorization

cookieSession
cookie__Host-werft_session<token>

For the web console: the browser session cookie set by POST /v1/auth/login. It holds the scopes of the user's workspace role (owner: all; admin and member: all but sessions:recover). Requests other than GET must also send X-Requested-With: werft-web.

Path Parameters

id*string

The agent's id.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
binding_id*string

The credential binding's id.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Header Parameters

X-Requested-With?"werft-web"

Required with a cookie session: the literal werft-web.

Value in"werft-web"

Response Body

Success

application/json
  1. response
binding*
revoke_notice*string
receipt_id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
Example Request
curl -X DELETE 'https://example.com/v1/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/credential-bindings/497f6eca-6276-4993-bfeb-53cbbbba6f08'
Example Response
{  "binding": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",    "credential_ref": "string",    "bound_by": "f885367a-4556-40be-b295-386f020c1354",    "bound_at": "2019-08-24T14:15:22Z",    "revoked_at": "2019-08-24T14:15:22Z",    "running_sessions": 0  },  "revoke_notice": "해제하면 실행 중인 세션도 다음 메시지부터 막히고, 원격 MCP 호출은 30초 안에 끊겨요. 이미 보낸 호출은 끝까지 실행되니 값 자체는 외부 서비스에서 폐기하세요",  "receipt_id": "64d0a161-468e-472a-b00e-a06ee9ab7de7"}