Skip to content
Agents
Scopes

Delete Scope

DELETE
/v1/scopes/{scope_id}
curl --request DELETE \
--url https://agents.lumalabs.ai/v1/scopes/example \
--header 'Authorization: Bearer <token>'

Delete a scope and everything in it.

Answers to the API key, which deletes your client's scopes created without a tenant_id, or to a session token minted with a tenant_id, which deletes that tenant's scopes. A session token minted without a tenant_id deletes none and gets 404 SCOPE.NOT_FOUND. Refused with 409 SCOPE.HAS_ACTIVE_SESSIONS while any session in the scope is still active; end those first with DELETE /v1/sessions/{id}. A deleted scope answers 404 from then on, and its key is free to name a new scope.

scope_id
required
Scope Id
string

Successful Response

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}