Skip to main content
POST
Search

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization
string
header
required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

ArtifactServiceSearchRequest searches only audience-visible catalog metadata. Consumers must deduplicate grant-derived candidates before pagination, strongly recheck canonical metadata and current grants before disclosure, and reject stale query-relevant observations. Order is created_at then id, both descending. Cursor validation must bind authenticated tenant/user, filters, ordering and last consumed boundary; these semantic checks are not generated validators. Candidate scanning must be bounded; rejected candidates still advance the consumed boundary, without exposing candidate or rejection counts.

pageSize
integer<int32>

Maximum number of results per page; zero selects the service default, 20.

pageToken
string

Sealed continuation token from a previous response with the same filters.

query
string

Free-text query matched against current catalog display name and description. Empty means no text filter; source text and live data are never searched.

tags
string[] | null

Require all specified topic tags; empty means no tag filter.

Response

200 - application/json

ArtifactServiceSearchResponse contains only currently authorized metadata. Readers see published Artifacts; Owners may also see their unpublished entries. No raw candidate totals, denied/scanned counts or global facets are exposed.

ArtifactServiceSearchResponse contains only currently authorized metadata. Readers see published Artifacts; Owners may also see their unpublished entries. No raw candidate totals, denied/scanned counts or global facets are exposed.

list
Artifact · object[] | null

Authorized Artifacts in descending creation-time and ID order.

nextPageToken
string

Sealed continuation token, empty when scanning is complete. A short or empty page can still continue; this token does not promise another visible match.