Lists the commands, skills and agents the session's tool reports.

GET

/v1/m/sessions/runs/{ref}/commands

curl --request GET \
  --url https://example.com/v1/m/sessions/runs/example/commands \
  --header 'Authorization: Bearer <token>'

• this engine

Lists the commands, skills and agents the session’s tool reports.

Authorizations

• bearerAuth
• browserSession

Parameters

Path Parameters

ref

required

string

Path parameter ref.

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Responses

200

The commands, skills and agents the session’s tool reports

Media type application/json

object

commands

required

Array<object>

object

argument_hint

How the tool shows the arguments, when it does.

string

description

required

One line, as the tool wrote it.

string

insert_text

Native invocation when it is not /name, without trailing space (Codex skills use $name).

string

kind

required

A command is a slash command or a skill; both are typed as /name.

string

Allowed values: command agent

name

required

What follows the slash, without it.

string

source

required

Where the command comes from, when the tool says so.

string

Allowed values: "" built-in user project plugin

reported

required

False when the tool reported nothing: the session is not live on this node, or its tool is not read yet.

boolean

stale

True when the last ask of the tool failed and the commands are what it reported before.

boolean

tool

required

The session’s tool; empty when the session is not live on this node.

string

Example

{
  "commands": [
    {
      "kind": "command",
      "source": ""
    }
  ]
}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

The session’s launch is no longer its authority, or its work lease needs a fence

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}

502

The tool refused or could not be asked for its commands

Media type application/json

object

Example ^generated

{}

504

The tool did not report its commands in time

Media type application/json

object

Example ^generated

{}