Get task run

{
  "type": "object",
  "description": "Detail response for a task run.\n\nReads from a frozen ``TaskRunDetailDTO`` produced by the facade mapper (which computes the\npresigned ``log_url`` and parses ``runtime_adapter`` / ``provider`` / ``model`` /\n``reasoning_effort`` off the run state). ``task`` is the parent task id. Reused as the nested\n``latest_run`` shape by the task detail response.",
  "required": [
    "artifacts",
    "branch",
    "environment",
    "error_message",
    "id",
    "output",
    "stage",
    "state",
    "status",
    "task"
  ],
  "properties": {
    "artifacts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "type",
          "uploaded_at"
        ],
        "properties": {
          "content_type": {
            "type": "string",
            "description": "Optional MIME type"
          },
          "dismissed_at": {
            "type": "string",
            "description": "Timestamp when a user dismissed the artifact. Absent while the artifact is shown."
          },
          "id": {
            "type": "string",
            "description": "Stable identifier for the artifact within this run"
          },
          "metadata": {
            "description": "Structured metadata for a skill bundle or a PostHog object reference.",
            "type": "object"
          },
          "name": {
            "type": "string",
            "description": "Artifact file name"
          },
          "size": {
            "type": "integer",
            "description": "Artifact size in bytes"
          },
          "source": {
            "type": "string",
            "description": "Source of the artifact, such as agent_output or user_attachment"
          },
          "storage_path": {
            "type": "string",
            "description": "S3 object key for file artifacts. Reference artifacts do not have one."
          },
          "type": {
            "type": "string",
            "description": "Artifact classification (plan, context, etc.)"
          },
          "uploaded_at": {
            "type": "string",
            "description": "Timestamp when the artifact was uploaded or registered"
          },
          "uploaded_by": {
            "description": "Whether the artifact version was uploaded by the task agent or an interactive user.\n\n* `agent` - agent\n* `user` - user",
            "type": "object"
          },
          "uploaded_by_user_id": {
            "type": "integer",
            "description": "User id for an interactive user upload. Absent for agent uploads and legacy entries."
          },
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Stable download URL for the artifact. Populated on the finalize-upload response so the caller can link to the file; it redirects to a fresh presigned URL on each request and is not persisted on the manifest."
          }
        }
      }
    },
    "branch": {
      "type": [
        "string",
        "null"
      ]
    },
    "completed_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "created_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "environment": {
      "type": "string"
    },
    "error_message": {
      "type": [
        "string",
        "null"
      ]
    },
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "log_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "description": "Presigned S3 URL for log access (valid for 1 hour)."
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "Configured LLM model identifier for this run."
    },
    "output": {
      "type": [
        "object",
        "null"
      ]
    },
    "preview_available": {
      "type": "boolean",
      "description": "True when this run's sandbox serves a dev stack preview, so clients can offer the preview link. Open it through the run's `preview/` endpoint, which mints a fresh access token on every request."
    },
    "provider": {
      "description": "Configured LLM provider for this run, such as 'anthropic' or 'openai'.\n\n* `anthropic` - anthropic\n* `openai` - openai",
      "type": "object"
    },
    "reasoning_effort": {
      "description": "Configured reasoning effort for this run when the selected model supports it.\n\n* `off` - off\n* `minimal` - minimal\n* `low` - low\n* `medium` - medium\n* `high` - high\n* `xhigh` - xhigh\n* `max` - max\n* `ultracode` - ultracode",
      "type": "object"
    },
    "runtime_adapter": {
      "description": "Configured runtime adapter for this run, such as 'claude' or 'codex'.\n\n* `claude` - claude\n* `codex` - codex",
      "type": "object"
    },
    "stage": {
      "type": [
        "string",
        "null"
      ]
    },
    "state": {
      "type": "object"
    },
    "status": {
      "type": "string"
    },
    "task": {
      "type": "string",
      "format": "uuid",
      "description": "Parent task id this run belongs to."
    },
    "updated_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    }
  }
}