List custom instructions

Retrieve the AI Agent’s custom instructions, live and inactive, in cursor-paginated pages ordered by id.

Pagination is cursor-based: read meta.next_page_url and replay it verbatim to fetch the next page. next_page_url is null on the last or empty page.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

cursorstringOptional

The id that marks the start of the returned records. Use the value from meta.next_page_url in the previous response.

limitintegerOptional1-100

The number of records to return

Response

datalist of objects

The list of custom instructions

metaobject

Pagination metadata

Errors

400

Bad Request Error

401

Unauthorized Error

429

Too Many Requests Error

500

Internal Server Error

1	import requests
2
3	url = "https://example.ada.support/api/v2/custom-instructions/"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"data": [
3	{
4	"id": "65a17e3f43bec88e2792d0eb",
5	"title": "Refund policy",
6	"text": "Always confirm the order number before issuing a refund.",
7	"enabled": true,
8	"notes": {}
9	}
10	],
11	"meta": {
12	"next_page_url": {}
13	}
14	}