Skip to content
Agents
Scopes

List Scopes

GET
/v1/scopes
curl --request GET \
--url 'https://agents.lumalabs.ai/v1/scopes?limit=25' \
--header 'Authorization: Bearer <token>'

Keyset-paginated list of scopes visible to this tenant, newest first.

limit
Limit
integer
default: 25 >= 1 <= 100
cursor
Any of:
string

Opaque token from a previous page's next_cursor.

Successful Response

Media typeapplication/json
ListScopesResponse

Keyset-paginated scope list (GET /v1/scopes).

No total count: a partner with many workspaces shouldn't pay for a count() per page. next_cursor is opaque — pass it back unchanged.

object
data
required
Data
Array<object>
ScopeResponse
object
client_id
required
Client Id
string
client_key
Any of:
string
config
Any of:
object
key
additional properties
any
created_at
required
Created At
string format: date-time
display_name
Any of:
string
expires_at
Any of:
string format: date-time
replayed
Replayed

True when a create re-posted an existing key and this is the scope that key already names.

boolean
scope_id
required
Scope Id

UUID identifying this scope. Pass as scope_id when creating sessions.

string
state
required
State
string
tenant_id
Any of:
string
has_more
required
Has More
boolean
next_cursor
Any of:
string
Example
{
"data": [
{
"replayed": false
}
]
}

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"
}
]
}