Skip to main content
Check whether an artifact has been indexed (text extracted, chunked, and embedded).

Request

GET /v1/artifacts/{artifact_id}/status
artifact_id
string
required
UUID of the artifact.

Response

artifact_id
string
UUID of the artifact.
workspace_id
string
Workspace it belongs to.
artifact_type
string
The artifact type.
indexed
boolean
Whether indexing is complete.
span_count
integer
Number of spans generated.
total_tokens
integer
Total tokens across all spans.
indexed_at
string
ISO 8601 timestamp of indexing completion.

Example

status = client.artifact_status("a1b2c3d4-...")
print(f"Indexed: {status['indexed']}, Spans: {status['span_count']}")
Response
{
  "artifact_id": "a1b2c3d4-...",
  "workspace_id": "ws_acme",
  "artifact_type": "chat_turn",
  "indexed": true,
  "span_count": 3,
  "total_tokens": 187,
  "indexed_at": "2026-03-09T14:30:01Z"
}
This endpoint is most useful when ASYNC_INDEXING=true. With synchronous indexing (default), artifacts are indexed inline and indexed is always true in the ingest response.