Providers

Discover saved image and video provider connections.

Base URL: https://app.gavana.ai/api/canvas-agent/v1 · Authentication: HTTP bearer, token format cba_<token-id>.<secret>

Operations

Operation	Purpose	Scopes
`GET /providers`	List saved image and video provider connections	image:generate?, video:generate?

`GET /providers`

List saved image and video provider connections

Operation id: listProviders
Scopes: Requires at least one of image:generate or video:generate.
CLI equivalent: gavana provider list

Parameters

Parameter	In	Type	Required	Notes
`limit`	query	integer	No	Maximum number of items in this page. min 1, max 100.
`cursor`	query	string	No	Opaque continuation cursor from page.nextCursor. Reuse it with the same list filters. max length 8192.

Responses

Status	Payload	Meaning
`200`	object	Saved image-provider connections with masked credentials.
`default`	ErrorResponse	A stable machine-readable error. The response always includes X-Request-ID.

200 response body

Field	Type	Required	Notes
`connections`	array of ProviderConnection	Yes	—
`connections[].id`	string	Yes	Pattern `^[A-Za-z0-9_-]{1,180}$`.
`connections[].provider`	string	Yes	One of `openai`, `google/nano-banana`, `black-forest-labs`, `recraft`, `ideogram`, `qwen`, `openrouter`.
`connections[].name`	string	Yes	—
`connections[].maskedKey`	string	Yes	—
`connections[].models`	array of string	Yes	—
`page`	CursorPage	Yes	—
`page.limit`	integer	Yes	min 1, max 200.
`page.hasMore`	boolean	Yes	—
`page.nextCursor`	string \| null	Yes	max length 8192.

Example


curl "https://app.gavana.ai/api/canvas-agent/v1/providers" \
  -H "Authorization: Bearer $GAVANA_AGENT_TOKEN"

Errors

Every failure uses the shared error envelope described in Errors and X-Request-ID. The response always carries X-Request-ID; share that value with support instead of the request payload.