Skip to main content
GET
/
projects
/
{project_reference}
/
agents
List project agents for a runtime target
curl --request GET \
  --url https://api.veryfront.com/projects/{project_reference}/agents \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "provider": {
        "organization": "<string>",
        "url": "<string>"
      },
      "version": "<string>",
      "capabilities": {
        "streaming": true,
        "pushNotifications": true,
        "extensions": [
          "<string>"
        ]
      },
      "defaultInputModes": [
        "<string>"
      ],
      "defaultOutputModes": [
        "<string>"
      ],
      "skills": [
        {
          "id": "<string>",
          "name": "<string>",
          "description": "<string>",
          "tags": [
            "<string>"
          ],
          "examples": [
            "<string>"
          ]
        }
      ],
      "x-veryfront-model": "<string>",
      "x-veryfront-url": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

Authentication via JWT token or API key. JWT: Get from Veryfront dashboard. API Key: Format "vf__" - create via /api-keys endpoint.

Path Parameters

project_reference
string
required

Project ID or slug

Query Parameters

runtime_target_kind
enum<string>
default:production
Available options:
production,
environment,
preview_branch
target_environment_id
string<uuid> | null
target_branch_id
string<uuid> | null

Response

Discovered project agents

data
object[]
required