CLI sign-ins

A CLI sign-in is one computer where clanker auth login signed in as you. The website's Security settings list them too.

The CliSession object

One computer where the clanker CLI signed in as you.

Attributes

idstringRequired

Unique ID of the CLI sign-in.

createdAtstringRequired

When clanker auth login signed in, as an ISO 8601 timestamp.

expiresAtstringRequired

When the sign-in ends unless the CLI is used again, as an ISO 8601 timestamp.

The CliSession object

{  "id": "Cs8vN1qLm3Zx",  "createdAt": "2026-10-01T16:20:00.000Z",  "expiresAt": "2026-10-14T09:05:12.000Z"}

List CLI sign-ins

GET/v1/me/cli-sessions

Returns the computers where the clanker CLI is signed in as you. Account API keys have none.

Returns

Returns an object with these fields. Status 200.

sessionsarray of CliSession objectsRequired

Your CLI sign-ins that have not ended.

Errors

400: InvalidInputThe request is malformed, or a value is not allowed.
401: UnauthorizedThe request has no valid API key.
403: ForbiddenThe key's user or role may not do this.
404: NotFoundThe workspace or object does not exist, or the caller cannot see it.
409: ConflictThe change conflicts with current data, such as a slug that is already in use.
500: InternalClanker Ship failed to handle the request. Retry, or report the response's x-request-id.

GET/v1/me/cli-sessions

1curl https://api.clankership.com/v1/me/cli-sessions \2  -H "Authorization: Bearer $CLANKER_API_KEY"

Response200

{  "sessions": [    {      "id": "Cs8vN1qLm3Zx",      "createdAt": "2026-10-01T16:20:00.000Z",      "expiresAt": "2026-10-14T09:05:12.000Z"    }  ]}

Revoke a CLI sign-in

POST/v1/me/cli-sessions/{session}/revoke

Ends one of your CLI sign-ins, so the CLI on that computer must sign in again. Fails with NotFound when the sign-in is not yours or has already ended.

Path parameters

sessionstringRequired

The sign-in's ID, such as Cs8vN1qLm3Zx.

Returns

Returns an object with these fields. Status 200.

okbooleanRequired

Always true: the change was made.

Always true

Errors

400: InvalidInputThe request is malformed, or a value is not allowed.
401: UnauthorizedThe request has no valid API key.
403: ForbiddenThe key's user or role may not do this.
404: NotFoundThe workspace or object does not exist, or the caller cannot see it.
409: ConflictThe change conflicts with current data, such as a slug that is already in use.
500: InternalClanker Ship failed to handle the request. Retry, or report the response's x-request-id.

POST/v1/me/cli-sessions/{session}/revoke

1curl -X POST https://api.clankership.com/v1/me/cli-sessions/{session}/revoke \2  -H "Authorization: Bearer $CLANKER_API_KEY"

Response200

{  "ok": true}

NextWorkspaces