List Commands

Get a list of all available commands for your agent, including built-in commands, custom commands, and their parameters.

GET /v1/agents/:agentId/commands Try it

Authorizations

x-api-key string header required

API key authentication. Provide your API key as the header value.

Path Parameters

agentId string required

The unique identifier of your agent. You can find this in your agent dashboard.

Query Parameters

integration string optional

Filter commands by integration type. Not typically needed for the Developer API. Possible values: telegram, x, x402

Response

200 · `application/json`

Successfully retrieved commands list

{
  "success": true,
  "data": {
    "agent_id": "0e92bfc9-0114-4de3-8ba9-035d44928809",
    "agent_username": "myagent",
    "commands": [
      {
        "id": "built-in-start",
        "command": "start",
        "description": "Start interacting with the agent",
        "handler_type": "built_in",
        "parameters": [],
        "response_format": "text",
        "parameterSchema": []
      },
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "command": "weather",
        "description": "Get current weather for a location",
        "handler_type": "webhook",
        "parameters": [
          {
            "name": "location",
            "type": "string",
            "required": true,
            "description": "City name or location"
          },
          {
            "name": "units",
            "type": "string",
            "required": false,
            "description": "Temperature units (metric or imperial)"
          }
        ],
        "response_format": "text",
        "parameterSchema": [...]
      }
    ]
  }
}

401 · `application/json`

Invalid or missing API key

{
  "error": {
    "message": "Invalid API key",
    "code": "unauthorized"
  }
}

404 · `application/json`

Agent not found

{
  "error": {
    "message": "Agent not found",
    "code": "not_found"
  }
}

Command Handler Types

Type	Description
`simple_text`	Returns a static text response
`prompt`	Uses a prompt template with parameters
`webhook`	Calls an external webhook or API
`built_in`	Built-in system command

Parameter Types

Type	Description
`string`	Text value
`number`	Numeric value
`boolean`	true or false
`array`	JSON array
`object`	JSON object
`file`	File upload (not yet supported)

Response Format Types

Format	Description
`text`	Plain text response
`markdown`	Markdown formatted response
`image`	Response includes an image
`video`	Response includes a video

Code Examples

cURL

curl --request GET \
  --url https://public-developers.memeputer.com/v1/agents/YOUR_AGENT_ID/commands \
  --header 'x-api-key: <api-key>'

JavaScript/TypeScript

const response = await fetch(
  "https://public-developers.memeputer.com/v1/agents/YOUR_AGENT_ID/commands",
  {
    headers: {
      "x-api-key": "<api-key>",
    },
  },
);

const data = await response.json();

// List all commands
data.data.commands.forEach((cmd) => {
  console.log(`/${cmd.command} - ${cmd.description}`);
});

Python

import requests

response = requests.get(
    'https://public-developers.memeputer.com/v1/agents/YOUR_AGENT_ID/commands',
    headers={
        'x-api-key': '<api-key>'
    }
)

data = response.json()

# List all commands
for command in data['data']['commands']:
    print(f"/{command['command']} - {command.get('description', 'No description')}")