---
title: Runs
full: true
_openapi:
  toc:
    - depth: 2
      title: '`GET /v1/runs` - list workspace runs.'
      url: '#get-v1runs---list-workspace-runs'
    - depth: 2
      title: '`POST /v1/runs` - create a workspace run.'
      url: '#post-v1runs---create-a-workspace-run'
    - depth: 2
      title: '`GET /v1/runs/:id` - fetch a run and recent traces.'
      url: '#get-v1runsid---fetch-a-run-and-recent-traces'
    - depth: 2
      title: '`PATCH /v1/runs/:id` - update a run.'
      url: '#patch-v1runsid---update-a-run'
    - depth: 2
      title: '`GET /v1/runs/:id/events` - list events for a run timeline.'
      url: '#get-v1runsidevents---list-events-for-a-run-timeline'
    - depth: 2
      title: '`POST /v1/runs/:id/events` - append an event to a run timeline.'
      url: '#post-v1runsidevents---append-an-event-to-a-run-timeline'
    - depth: 2
      title: '`GET /v1/runs/:id/traces` - list traces for a run.'
      url: '#get-v1runsidtraces---list-traces-for-a-run'
  structuredData:
    headings:
      - content: '`GET /v1/runs` - list workspace runs.'
        id: get-v1runs---list-workspace-runs
      - content: '`POST /v1/runs` - create a workspace run.'
        id: post-v1runs---create-a-workspace-run
      - content: '`GET /v1/runs/:id` - fetch a run and recent traces.'
        id: get-v1runsid---fetch-a-run-and-recent-traces
      - content: '`PATCH /v1/runs/:id` - update a run.'
        id: patch-v1runsid---update-a-run
      - content: '`GET /v1/runs/:id/events` - list events for a run timeline.'
        id: get-v1runsidevents---list-events-for-a-run-timeline
      - content: '`POST /v1/runs/:id/events` - append an event to a run timeline.'
        id: post-v1runsidevents---append-an-event-to-a-run-timeline
      - content: '`GET /v1/runs/:id/traces` - list traces for a run.'
        id: get-v1runsidtraces---list-traces-for-a-run
    contents: []
---

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document={"../../docs/openapi.yaml"} webhooks={[]} operations={[{"path":"/v1/runs","method":"get"},{"path":"/v1/runs","method":"post"},{"path":"/v1/runs/{id}","method":"get"},{"path":"/v1/runs/{id}","method":"patch"},{"path":"/v1/runs/{id}/events","method":"get"},{"path":"/v1/runs/{id}/events","method":"post"},{"path":"/v1/runs/{id}/traces","method":"get"}]} showTitle showDescription />