Cloud Connect

List projects available for Cloud Connect attachment

Returns every project the authenticated caller may attach an enrolled Cloud Connect instance to. Policy is evaluated entirely by the server: today, results include only live, unattached standalone projects in the resolved organization, and user credentials require that organization's owner or admin role. Exactly one organization is searched per request and the response names it in org, so an empty projects states which organization has no eligible project rather than leaving a client to wonder whether the one it meant was searched at all; name another with X-Org-Name. Clients must render every returned project and instance without applying their own eligibility filters. The instances array is part of the stable contract and may be populated when server policy permits projects with existing attachments.

get/v1/cloud-connect/attachable-projects

Request

  • Base URL
    https://api.spice.ai
  • Auth
    HTTP bearer

Query parameters

limitinteger

Maximum number of projects to return.

cursorstring

Opaque cursor returned as next_cursor by the previous page.

Headers

X-Org-Namestring

Organization to list. A user token may name any organization its owner belongs to; naming one they do not is org_forbidden. Never ignored: a token bound to one organization that names another is org_assertion_mismatch. A portal session token is bound to none and must send it (org_assertion_required).

Response

A page of projects currently eligible for attachment.

orgstring required

Handle of the organization the page was scoped to, being the one X-Org-Name named or the credential's own when it named none. Always present, so an empty projects says which organization has no eligible project rather than leaving a client to guess whether its active organization was the one searched.

next_cursorstring nullable required

Opaque cursor for the next page, or null at the end.

Changes

No recorded changes to this operation across all 1 revision of this API.