Integrations

List integrations

Changed on

List integrations the user has access to, ordered by creation time (newest first). The default list covers LLM and AGENT integrations only; pass ?type=EVALUATOR to retrieve evaluator integrations. EVALUATOR is excluded from the default list to keep the cursor contract stable — it is a distinct, feature-flagged surface whose inclusion would shift existing type ranks and invalidate in-flight cursors. Each item carries its type (and, for LLM, config.provider) for client-side discrimination. An invalid type or pagination cursor returns 400; a cursor is only valid for the query parameters it was issued with.

Integrations are owned at the account level but carry visibility scopings (account-wide, organization, or space). space_id / space_name filter the list to integrations visible in a given space. The list contains only the types the caller has permission to read. When no type is readable the request fails with 403 — or 404 when a space_id filter references a space outside the caller's visibility.

<Warning>This endpoint is in alpha, read more here.</Warning>

get/v2/integrations

Request

  • Base URL
    https://api.arize.com
  • URL
    https://api.arize.com/v2/integrations
  • Auth
    HTTP bearer

Query parameters

type'LLM' | 'AGENT' | 'EVALUATOR'

The integration category. Selects the shape of config. Additive — new types (alerting, webhook, ...) are added non-breakingly.

  • LLM — a model-provider integration (e.g. OpenAI).
  • AGENT — connects your own agent, exposed at an HTTP endpoint.
  • EVALUATOR — connects a remote evaluator endpoint. Only returned when ?type=EVALUATOR is passed explicitly; excluded from the default (LLM + AGENT) list to keep the cursor contract stable. Requires the remote evaluators feature to be enabled.

Filter the list to a single integration type. When omitted, LLM and AGENT integrations are returned; EVALUATOR integrations must be requested explicitly with type=EVALUATOR. Each item carries its type for client-side discrimination.

space_idstring

A universally unique identifier (base64-encoded opaque string).

Example:RW50aXR5OjEyMzQ1

Filter search results to a particular space ID

space_namestring

Case-insensitive substring filter on the space name. Narrows results to resources in spaces whose name contains the given string. If omitted, no space name filtering is applied and all resources are returned.

namestring

Case-insensitive substring filter on the resource name. Returns only resources whose name contains the given string. For example, name=prod matches "production", "my-prod-dataset", etc. If omitted, no name filtering is applied and all resources are returned.

limitinteger

Maximum items to return. Defaults to 50 if omitted; maximum is 100.

cursorstring

Opaque pagination cursor returned from a previous response (pagination.next_cursor). Treat it as an unreadable token; do not attempt to parse or construct it.

Response

A paginated, polymorphic list of integrations.

Changes

    • breaking

      added to the ////// response property oneOf list for the response status

    • info

      added TOGETHER_AI discriminator mapping keys to the ////// response property for the response status

    • info

      added the required property /////////// to the response with the status

    • breaking

      added to the ////// response property oneOf list for the response status

    • info

      added FIREWORKS discriminator mapping keys to the ////// response property for the response status