Skip to main content
Version: 2.0

List Instructions API Definition

The List Instructions API enables you to retrieve a paginated list of all behavioral instructions available to the authenticated user. This is useful for managing and monitoring instruction sets across different agents and use cases.

List Instructions Request and Response

To list instructions, send a GET request to /v2/instructions. You can include optional query parameters to filter and paginate results:

  • filter (string, optional): A regex to match against instruction names or descriptions.
  • enabled (boolean, optional): Filter by whether instructions are currently enabled.
  • limit (integer, optional): Maximum number of instructions to return (default: 10).
  • page_key (string, optional): Used to paginate through results.

The response includes an array of instruction definitions and a metadata object with pagination info.

Example Request

EXAMPLE REQUEST
1

Example Response

EXAMPLE RESPONSE
1

Error Responses

The API returns standard HTTP error codes with detailed error information:

HTTP CodeError CodeDescription
400invalid_requestInvalid query parameters or malformed request
401unauthorizedInvalid or missing API key
403forbiddenInsufficient permissions for listing instructions
429rate_limit_exceededRequest rate limit exceeded