Skip to content
Soljio Docs
Esc
↑↓navigate↵open⌘Jpreview

List credential metadata without secrets.

List credential metadata without secrets. An organization-scoped read using JSON filter arguments; requires staff.read. Pagination cursors must be reused only with the same organization, operation and filters.

POST/queries/list_service_tokens
Authorization
AuthorizationBearer token (soljio_sk_<secret>) · headerrequired

Organization-scoped service token created by an owner/admin. Scope requirements are in x-required-scopes; these are service-token grants, not OAuth scopes. Revoked, expired, unknown and suspended-organization credentials all return 401.

Request body
requiredapplication/json
now_msstring<date-time>required
Responses
200

Successful read.

dataobjectrequired
Show properties
agentsobject[]required
Show properties
Array of object
client_namestring
connected_atstring<date-time>required
connected_by_labelstring
connector_access_endedbooleanrequired
idstringrequired

Opaque Soljio resource ID.

min length 1
last_used_atstring<date-time>
scopesstring[]required
Show properties
Array of string
Any of:
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
statusstringrequired
Show properties
Any of:
string
string
string
string
string
string
tokensobject[]required
Show properties
Array of object
created_atstring<date-time>required
created_by_labelstring
creator_access_revokedbooleanrequired
expires_atstring<date-time>required
expiry_warningstring
Show properties
Any of:
string
string
string
string
idstringrequired

Opaque Soljio resource ID.

min length 1
last_used_atstring<date-time>
namestringrequired
revoked_atstring<date-time>
rotated_from_token_idstring

Opaque Soljio resource ID.

min length 1
scopesstring[]required
Show properties
Array of string
Any of:
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
string
statusstringrequired
Show properties
Any of:
string
string
string
string
string
string
string
string
token_prefixstringrequired
viewer_rolestring
Show properties
Any of:
string
string
string
string
string
string
string
string
request_idstring<uuid>required
400

invalid_request

errorobjectrequired
Show properties
codestringrequired
Allowed:invalid_request
messagestringrequired
request_idstring<uuid>required
401

unauthorized

errorobjectrequired
Show properties
codestringrequired
Allowed:unauthorized
messagestringrequired
request_idstring<uuid>required
403

forbidden

errorobjectrequired
Show properties
codestringrequired
Allowed:forbidden
messagestringrequired
request_idstring<uuid>required
404

not_found

errorobjectrequired
Show properties
codestringrequired
Allowed:not_found
messagestringrequired
request_idstring<uuid>required
405

method_not_allowed

errorobjectrequired
Show properties
codestringrequired
Allowed:method_not_allowed
messagestringrequired
request_idstring<uuid>required
409

conflict, idempotency_conflict

errorobjectrequired
Show properties
codestringrequired
Allowed:conflictidempotency_conflict
messagestringrequired
request_idstring<uuid>required
413

payload_too_large

errorobjectrequired
Show properties
codestringrequired
Allowed:payload_too_large
messagestringrequired
request_idstring<uuid>required
415

unsupported_media_type

errorobjectrequired
Show properties
codestringrequired
Allowed:unsupported_media_type
messagestringrequired
request_idstring<uuid>required
429

rate_limited

errorobjectrequired
Show properties
codestringrequired
Allowed:rate_limited
messagestringrequired
request_idstring<uuid>required
500

internal_error

errorobjectrequired
Show properties
codestringrequired
Allowed:internal_error
messagestringrequired
request_idstring<uuid>required
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST 'https://api.soljio.com/v0/queries/list_service_tokens' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "now_ms": "2019-08-24T14:15:22Z"
}'
Response
{
  "data": {
    "agents": [
      {
        "client_name": "string",
        "connected_at": "2019-08-24T14:15:22Z",
        "connected_by_label": "string",
        "connector_access_ended": true,
        "id": "string",
        "last_used_at": "2019-08-24T14:15:22Z",
        "scopes": [
          "communications.messages.read"
        ],
        "status": "active"
      }
    ],
    "tokens": [
      {
        "created_at": "2019-08-24T14:15:22Z",
        "created_by_label": "string",
        "creator_access_revoked": true,
        "expires_at": "2019-08-24T14:15:22Z",
        "expiry_warning": "action_needed",
        "id": "string",
        "last_used_at": "2019-08-24T14:15:22Z",
        "name": "string",
        "revoked_at": "2019-08-24T14:15:22Z",
        "rotated_from_token_id": "string",
        "scopes": [
          "communications.messages.read"
        ],
        "status": "active",
        "token_prefix": "string"
      }
    ],
    "viewer_role": "owner"
  },
  "request_id": "266ea41d-adf5-480b-af50-15b940c2b846"
}