ArtifactService

ListArtifacts

List artifacts in the caller's organization, optionally filtered to one conversation.

get/api/v1/artifacts

Request

  • Base URL: https://api.siftstack.com
  • URL: https://api.siftstack.com/api/v1/artifacts
  • Auth: HTTP bearer

Query parameters

conversationIdstring

Unset lists every artifact in the caller's organization.

pageSizeinteger
pageTokenstring
filterstring

A Common Expression Language (CEL) filter string. Available fields are artifact_id, organization_id, created_by_user_id, storage_class, created_via, title, file_name, file_type, version, created_date, version_created_date (last updated), archived_date, the include_archived directive, and metadata through metadata["<key>"]. File type is the lowercase extension or MIME subtype; images use "image", structured artifacts use "json", and artifacts without a file use "file". Links can be filtered with a comprehension such as links.exists(l, l.relation == "ATTACHED_TO" && l.entity_type == "CONVERSATION" && l.entity_id == "<id>"). Link sub-fields are relation, entity_type, entity_id, and artifact_version_id. Enum fields compare against proto value names without the prefix, for example storage_class == "STRUCTURED", relation == "ATTACHED_TO", and entity_type == "CONVERSATION". The conversation_id field on this message combines with filter.

Archived artifacts are excluded unless the query says otherwise, either through include_archived == true or by filtering on archived_date, which governs archival on its own.

orderBystring

A comma-separated AIP-132 ordering string over created_date, version_created_date (last updated), archived_date, title, version, and file_type. Fields sort ascending by default and support a desc suffix. The default is created_date ascending.

Response

A successful response.

nextPageTokenstring

Changes

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