Revoke a CLI session using an approved device code.
POST
/v1/auth/device-codes/{id}/revoke-session
const url = 'https://api.share2.us/v1/auth/device-codes/example/revoke-session';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"session_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.share2.us/v1/auth/device-codes/example/revoke-session \ --header 'Content-Type: application/json' \ --data '{ "session_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'Narrow unauthenticated recovery endpoint used when device-code login was approved but session creation hit the plan’s CLI session cap. The device code must still be approved and unexpired, and the target session must belong to the same account and be a CLI session.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
session_id
required
string format: uuid
Examplegenerated
{ "session_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Responses
Section titled “Responses”Session revoked.
Media typeapplication/json
object
status
required
string
Example
{ "status": "ok"}default
Section titled “default”Standard error envelope.
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Example
{ "error": { "code": "quota_exceeded" }}