Source artifacts API

Read source snapshot metadata used by builds and workspace hydration. Artifacts are created through source upload and build workflows.

Use API authentication for protected requests. Examples use your own resource IDs and a temporary token; saved response examples are synthetic.

Method	Path	Operation
`GET`	`/v1/source_artifact`	List source artifacts
`GET`	`/v1/source_artifact/{id}`	Get source artifact

List source artifacts

GET /v1/source_artifact

Returns a paginated list of SourceArtifact

Authentication: bearer token and the team header shown below.

Parameters

Name	Location	Required	Description
`X-Tenant-ID`	header	yes	Active team ID. Must match the tenant bound to a diagnostic token.
`page`	query	no	Page number
`per_page`	query	no	Items per page

Request example

Set ADIOS_API_URL=https://api.adios.dev. For protected requests, set ADIOS_ACCESS_TOKEN and ADIOS_TEAM_ID as in the quickstart. Set any additional ADIOS_* variables from your own resource results.

curl --fail-with-body --request GET "$ADIOS_API_URL/v1/source_artifact" \
  -H "Authorization: Bearer $ADIOS_ACCESS_TOKEN" \
  -H "X-Tenant-ID: $ADIOS_TEAM_ID"

Response: HTTP 200

List of SourceArtifact

Response fields

Field	Type	Description
`data`	array
`data[].branch`	string
`data[].build_id`	string	Build that was produced from this source snapshot
`data[].commit_sha`	string
`data[].content_type`	string
`data[].created_at`	integer	(Unix timestamp)
`data[].deleted_at`	integer	(Unix timestamp)
`data[].digest`	string	Content digest of the source bundle
`data[].metadata`	object
`data[].repository_url`	string	Git repository URL when source_type is git
`data[].size_bytes`	integer
`data[].source_artifact_id`	string
`data[].source_type`	string	Allowed: upload, git, workspace, template, unknown.
`data[].system_artifact_id`	string	System object artifact identifier for the source bundle
`data[].system_object_key`	string
`data[].system_uri`	string
`data[].team_id`	string
`data[].updated_at`	integer	(Unix timestamp)
`data[].workload_id`	string
`pagination`	object
`pagination.page`	integer	Current page number
`pagination.per_page`	integer	Number of items per page
`pagination.total`	integer	Total number of items

Illustrative example; not a live response:

{
  "data": [
    {
      "branch": "",
      "build_id": "example",
      "commit_sha": "",
      "content_type": "",
      "created_at": 1791072000,
      "deleted_at": 0,
      "digest": "",
      "metadata": {},
      "repository_url": "example",
      "size_bytes": 0,
      "source_artifact_id": "000000000000000000000000001",
      "source_type": "unknown",
      "system_artifact_id": "example",
      "system_object_key": "",
      "system_uri": "",
      "team_id": "000000000000000000000000001",
      "updated_at": 1791072000,
      "workload_id": "000000000000000000000000001"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 1,
    "total": 1
  }
}

Get source artifact

GET /v1/source_artifact/{id}

Returns a single SourceArtifact

Set source_artifact_id using IDs from your own API responses.