Agent Docs

Read a qualified citation for public artifact metadata.

Preserve the returned qualification, date and recorded URL. A citation is not a new verification or execution claim. This handler uses the production Postgres backend. The local JSON fixture backend may not serve this route.

Inputs. Path, query and header fields are listed below. No request body is required.

Outputs. See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

Errors. API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

Rate limits. Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

Example setup. Use an identifier returned by the matching list, search or create operation. Sample identifiers are not a promise that a record exists.

get/api/artifacts/{id}/citation

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/artifacts/{id}/citation
  • Auth: none required

Path parameters

idstring required

Artifact identifier returned by search.

Query parameters

compat'containment'

Deprecated legacy response block opt-in for one release only.

Response

Read a qualified citation for public artifact metadata.

schemaVersion'hugging-bay.citation.v1' required
artifactIdstring required
repostring required
textstring required
textZhstring required
canonicalUrlstring required
publicEvidenceUrlstring required
publicEvidenceJsonUrlstring required
publicEvidenceCitationUrlstring required
datestring required
qualificationstring required
guidancestring required

Changes

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