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"
  }
]
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 List conversations, Generate Answer, and any other public route that scopes behavior to one agent. 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.