List authored tools | Rasen Developer API

{
  "items": [
    {
      "id": "tool_01j00000000000000000000000",
      "agent_id": "agent_01j00000000000000000000000",
      "revision": "example",
      "configuration": {
        "kind": "webhook",
        "deadline_ms": 8000,
        "definition": {
          "url": "https://api.example.com/orders",
          "method": "GET",
          "headers": [
            {
              "name": "Authorization",
              "value_type": "secret",
              "credential": {
                "secret_id": "sec_01j00000000000000000000000",
                "version": 1
              },
              "variable": "customer_name"
            }
          ],
          "parameters": [
            {
              "name": "lookup_order",
              "location": "path",
              "source": "model",
              "value": "example",
              "required": false,
              "schema": {
                "type": "string",
                "enum": [
                  "example"
                ],
                "description": "example",
                "minimum": 1,
                "maximum": 1
              }
            }
          ],
          "content_type": "application/json"
        },
        "description": "example",
        "effect_id_name": "example",
        "effect_id_placement": "header",
        "max_response_bytes": 32768,
        "name": "lookup_order",
        "retry_posture": "none",
        "side_effect": "none",
        "wait_for_response": true
      },
      "created_at": "2026-09-25T10:00:00Z"
    }
  ],
  "next_cursor": "eyJwYWdlIjoyfQ"
}

Lists authored webhook/MCP tools only. Effective built-in settings are draft.default_tools or version.default_tools. Published policies stay frozen. ID-list filters use repeated query names. Raw supplied ID count across fields is at most 100. Cursor binds normalized filters; filtered lists are not exact batch retrieval.

Authentication

AuthorizationBearer

Create and manage workspace-owned keys through the existing app session routes, outside this public API. Creator and manager identities are audit actors only. Key validity follows workspace policy, expiry and explicit revocation, independently of creator membership. Do not include a workspace-selection header.

Path parameters

agent_idstringRequired1-128 characters

Resource identity within the authenticated workspace.

Query parameters

limitintegerOptional1-200Defaults to 50

Page size; 50 by default, at most 200.

cursorstringOptional

Opaque cursor bound to the workspace, every filter, grouping and limit. Send them unchanged with it. Expires after 24 hours.

tool_idlist of stringsOptional

Repeat the query name for multiple IDs. OR within this field; AND across fields. Maximum 100 raw ID entries total across all ID filters. Blank values are invalid. Unknown/inaccessible IDs produce no rows, not an existence disclosure. An empty array is invalid and refused: SDKs refuse it before sending, and the server refuses an empty or blank value. Omission means no filter.

Response headers

X-Request-IdstringOptional

Safe server request correlation ID.

ETagstringOptional

Strong draft revision. Use this ETag for edits to this resource. Draft ETags cover complete authoring inputs.

RateLimit-LimitintegerOptional

Requests allowed in the current window for the tightest applicable limit.

RateLimit-RemainingintegerOptional

Requests left in the current window.

RateLimit-ResetintegerOptional

Seconds until the current window resets.

Response

List authored tools.

itemslist of objects

next_cursorstring or null

Opaque continuation cursor. Null means the last page.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error