artifacts ยท version 0.1.0

List Sourced-managed docs publications for a run

GET /api/runs/{runId}/docs-preview/publish

Returns active Sourced-hosted docs URLs created from the run's docs preview. These URLs remain noindex until the workspace explicitly moves to a production indexability policy.

Request

GET https://sourced.sh/api/runs/{runId}/docs-preview/publish

Parameters

NameLocationRequiredDescription
runIdpathYesRun identifier. string

Responses

200

Active Sourced-managed docs publications.

application/json

type: object
required: run, publications
properties:
  run (required): Run
    Run:
      type: object
      required: id, projectId, status, createdAt
      properties:
        id (required): string
        orgId: string
        projectId (required): string
        createdByUserId: string
        status (required): string enum queued | running | blocked | complete | ready | failed | expired | canceled
        mode: string enum flagship | stainless_compatible | custom | openapi | stainless | stainless_migration | reference-sample
        verdict: string enum queued | generated | ready | needs_review | not_ready | needs_worker | needs_setup | failed | canceled
        createdAt (required): string
        completedAt: string
        steps: array
          type: array
        inputSummary: object
        notes: string
        currentStep: string
        artifactManifest: ArtifactManifest
          ArtifactManifest:
            type: object
            properties:
              version: integer
              runId: string
              organizationId: string
              projectId: string
              quality: object
              artifacts: array
              expiresAt: string
        updatedAt: string
  publications (required): array
    type: array

401

403

404

Back to version index