> ## Documentation Index > Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Search > Search returns currently authorized Artifacts matching catalog text and tags. Discovery is eventual; newly granted access may appear later than a direct Get. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/search/artifacts openapi: 3.1.0 info: description: The C1 API is a HTTP API for managing C1 resources. title: C1 API version: 0.1.0-alpha servers: - description: The C1 API server for the current tenant. url: https://{tenantDomain}.conductor.one variables: tenantDomain: default: example description: The domain of the tenant to use for this request. security: - bearerAuth: [] oauth: [] paths: /api/v1/search/artifacts: post: tags: - Artifact summary: Search description: >- Search returns currently authorized Artifacts matching catalog text and tags. Discovery is eventual; newly granted access may appear later than a direct Get. operationId: c1.api.artifact.v1.ArtifactService.Search requestBody: content: application/json: schema: $ref: >- #/components/schemas/c1.api.artifact.v1.ArtifactServiceSearchRequest responses: '200': content: application/json: schema: $ref: >- #/components/schemas/c1.api.artifact.v1.ArtifactServiceSearchResponse description: >- 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. components: schemas: c1.api.artifact.v1.ArtifactServiceSearchRequest: description: >- 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. properties: pageSize: description: >- Maximum number of results per page; zero selects the service default, 20. format: int32 type: integer pageToken: description: >- Sealed continuation token from a previous response with the same filters. type: string query: description: >- Free-text query matched against current catalog display name and description. Empty means no text filter; source text and live data are never searched. type: string tags: description: Require all specified topic tags; empty means no tag filter. items: type: string type: - array - 'null' title: Artifact Service Search Request type: object x-speakeasy-name-override: ArtifactServiceSearchRequest c1.api.artifact.v1.ArtifactServiceSearchResponse: description: >- 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. properties: list: description: Authorized Artifacts in descending creation-time and ID order. items: $ref: '#/components/schemas/c1.api.artifact.v1.Artifact' type: - array - 'null' nextPageToken: description: >- Sealed continuation token, empty when scanning is complete. A short or empty page can still continue; this token does not promise another visible match. type: string title: Artifact Service Search Response type: object x-speakeasy-name-override: ArtifactServiceSearchResponse c1.api.artifact.v1.Artifact: description: |- Artifact is audience-visible catalog metadata, not an authoring package. It contains no source identities, storage references, cells or arguments. properties: createdAt: format: date-time readOnly: true type: - string - 'null' description: description: Optional audience-visible description; never guarded draft text. type: string displayName: description: >- Current Owner-managed catalog name, independent of pinned-version source text. Consumers reject Unicode-whitespace-only names without trimming valid names. type: string id: description: Unique opaque identifier for this Artifact. readOnly: true type: string publishedVersionNumericId: description: >- Exact current publication number; zero means unpublished. Never infer the current publication from the largest version number. JS clients use strings. format: int64 readOnly: true type: string tags: description: >- Optional unique lowercase ASCII topic tokens, not permissions or classifications. items: type: string type: - array - 'null' updatedAt: format: date-time readOnly: true type: - string - 'null' viewerUrl: description: |- Server-generated viewer link when published; empty when unpublished. This is not a download capability and every open checks current grants. readOnly: true type: string title: Artifact type: object x-speakeasy-name-override: Artifact securitySchemes: bearerAuth: scheme: bearer type: http oauth: description: >- 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()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187) function. flows: clientCredentials: scopes: {} tokenUrl: /auth/v1/token type: oauth2 ````