Skip to main content
GET
/
v2
/
bots
/
public
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/public' \
  --header 'Authorization: Bearer fini_your_api_key'

[
  {
    "id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
    "name": "Support Agent",
    "createdAt": "2026-05-20T12:34:56.789Z"
  },
  {
    "id": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b",
    "name": "Billing Agent",
    "createdAt": "2026-05-12T08:41:10.201Z"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.usefini.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns every agent in the workspace tied to your API key, sorted by creation time, newest first. Use it to look up the botId values accepted by the List interactions endpoint’s optional agent filter. This endpoint returns all agents in a single response, there is no pagination, filtering, or limit.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_...
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/public' \
  --header 'Authorization: Bearer fini_your_api_key'

​
Response

The response is a top-level array of agent objects.
​
[]
array
Array of agents in the workspace.
[
  {
    "id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
    "name": "Support Agent",
    "createdAt": "2026-05-20T12:34:56.789Z"
  },
  {
    "id": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b",
    "name": "Billing Agent",
    "createdAt": "2026-05-12T08:41:10.201Z"
  }
]

​
Errors

The workspace API key is missing, malformed, revoked, or invalid. Confirm you are sending Authorization: Bearer fini_... with the full key.
The key is valid but doesn’t include the read scope, or it’s scoped to a different workspace.
The key’s workspace has no non-deleted agents available to the public route. Create an agent in the dashboard or confirm you’re authenticating against the right workspace.