> ## Documentation Index > Fetch the complete documentation index at: https://docs.useorgx.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List artifact types > List the artifact types `POST /artifacts` accepts. Use a `type_code` from this list as the `artifact_type` when you register produced work. ### One global vocabulary The catalog is the same for every caller and takes no workspace parameter. Entries are seeded by migration, so this surface is read-only. `is_deliverable` is false for the types that describe run health rather than a produced deliverable. ### Freshness Responses are cacheable for five minutes. `meta.stale` is true when the catalog was served from the last successful load because a refresh failed. ## OpenAPI ````yaml /openapi/v1.yaml get /artifact-types openapi: 3.1.0 info: title: OrgX REST API v1 version: '1' description: >- Build accountable work into your product with OrgX REST API v1. Create work with one field, attach evidence when it is complete, and keep the receipt. Every authenticated request is scoped to the workspace resolved from your credential. Start with `POST /work`. Human guide: https://docs.useorgx.com/docs/api/quickstart contact: name: OrgX Support url: https://useorgx.com/support email: support@useorgx.com license: name: Proprietary url: https://useorgx.com/terms servers: - url: https://useorgx.com/api/v1 description: Production security: [] tags: - name: Work description: Create accountable work and complete it with evidence - name: Initiatives description: Organize related work around an outcome - name: Operating processes description: Evidence-backed company workflow/process lifecycle - name: Operating map description: Derived, rebuildable Operating Map projection over the process ledger - name: Discovery runs description: Wizard and deep-search workflow discovery over connected company sources - name: Handoffs description: Ledger-backed stage handoffs between operating-process stages - name: Events description: Replayable, workspace-scoped accepted ledger events - name: Projections description: Workspace-scoped, rebuildable read projections over OrgX sources - name: Episodes description: Mission-compatible Episode read adapters - name: Receipt validation description: Account-free Agent Work Receipt schema discovery and conformance - name: Receipt import description: Authenticated, workspace-scoped import into the hosted receipt ledger - name: Workload diagnosis description: >- Account-free evaluation of time, agents, systems, authority, and accountability boundaries - name: Content Studio description: >- Estimate, showcase, checkout, and payment event operations for Content Studio - name: Decisions description: Raise decisions for human ruling and read their state - name: Artifacts description: Register produced work against the entity it belongs to - name: Launches description: Preview and run an initiative launch through its spend gates - name: Runs description: Control agent runs with pause, resume, cancel, and rollback - name: Lifecycle description: Pause, resume, retry, or cancel work hierarchy nodes and runs - name: Deduplication description: Claim durable event fingerprints so duplicate triggers fire once - name: Credential description: >- Resolve the calling credential, the workspaces it reaches, and what it may do - name: API discovery description: Account-free error codes, request schemas, and closed vocabularies for v1 externalDocs: description: Human-readable OrgX REST API v1 reference url: https://docs.useorgx.com/docs/api/public-api paths: /artifact-types: get: tags: - Artifacts summary: List artifact types description: >- List the artifact types `POST /artifacts` accepts. Use a `type_code` from this list as the `artifact_type` when you register produced work. ### One global vocabulary The catalog is the same for every caller and takes no workspace parameter. Entries are seeded by migration, so this surface is read-only. `is_deliverable` is false for the types that describe run health rather than a produced deliverable. ### Freshness Responses are cacheable for five minutes. `meta.stale` is true when the catalog was served from the last successful load because a refresh failed. operationId: listArtifactTypes responses: '200': description: The global artifact type vocabulary content: application/json: schema: $ref: '#/components/schemas/ArtifactTypeListResponse' example: data: - type_code: prd label: Product requirements summary: A written product requirements deliverable. domain: product stage: deliver workflow: author default_persona: product-lead tags: - planning is_deliverable: true meta: apiVersion: '1' scope: global count: 1 stale: false '401': $ref: '#/components/responses/Unauthorized' '503': $ref: '#/components/responses/ServiceUnavailable' security: - bearerAuth: [] - cookieAuth: [] components: schemas: ArtifactTypeListResponse: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/ArtifactType' meta: type: object properties: apiVersion: type: string scope: type: string enum: - global description: The catalog is global; it carries no workspace scope. count: type: integer stale: type: boolean description: >- True when a refresh failed and the last successful catalog was served. ArtifactType: type: object description: One entry in the global artifact type vocabulary. required: - type_code - label - domain - stage - workflow - is_deliverable properties: type_code: type: string description: Send this value as artifact_type when creating an artifact. label: type: string summary: type: - string - 'null' domain: type: string stage: type: string workflow: type: string default_persona: type: - string - 'null' tags: type: array items: type: string is_deliverable: type: boolean description: >- False for types that describe run health rather than a produced deliverable. ApiError: type: object properties: error: type: object properties: code: type: string message: type: string details: type: object requestId: type: string timestamp: type: string format: date-time docsUrl: type: string format: uri retryAfter: type: integer description: Seconds until rate limit resets responses: Unauthorized: description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ApiError' ServiceUnavailable: description: Ledger or workspace authorization is unavailable content: application/json: schema: $ref: '#/components/schemas/ApiError' securitySchemes: bearerAuth: type: http scheme: bearer description: 'OrgX API key, sent as `Authorization: Bearer oxk_...`' cookieAuth: type: apiKey in: cookie name: __session description: Session cookie from web authentication ````