Test Runs

Get a test run

Returns a test run.

GET /api/public/v1/test-runs/{runId}

Get a test run

curl --request GET \
  --url 'https://api.buildprint.ai/api/public/v1/test-runs/{RUNID}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "run": {
    "id": "<string>",
    "createdAt": 1,
    "projectId": "<string>",
    "testId": "<string>",
    "conversationId": "<string>",
    "status": "queued",
    "branchCacheId": "<string>",
    "branchId": "<string>",
    "branchDisplay": "<string>",
    "model": "<string>",
    "environment": "live",
    "summary": "<string>"
  },
  "test": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>"
  },
  "steps": [
    {
      "id": "<string>",
      "position": 1,
      "sourceKind": "step",
      "sourceComponentId": "<string>",
      "sourceComponentName": "<string>",
      "instruction": "<string>",
      "details": "<string>",
      "onFailure": "stop",
      "status": "pending",
      "comment": "<string>",
      "completedAt": 1,
      "artifacts": [
        {}
      ]
    }
  ]
}

Run found

Authorizations

  • Authorization string required header

    Workspace REST API token prefixed with bp_

Path Parameters

  • runId string required

    Run ID.

Response

application/json
  • run object

    Detailed state for the test run.

    + Show Child Attributes
    • id string

      Opaque identifier for this resource.

    • createdAt number

      Unix timestamp in milliseconds when the resource was created.

    • projectId string

      Opaque identifier for the workspace project.

    • testId string

      Opaque identifier for the project test definition.

    • conversationId string

      Opaque identifier for the underlying AI conversation.

    • status string enum enum

      Current lifecycle status for the resource. 6 allowed enum values.

    • branchCacheId string | null

      Opaque identifier for the cached branch record when one is available.

    • branchId string

      Branch identifier or slug used for the run.

    • branchDisplay string

      Human-readable branch name used for the run.

    • model string | null

      Model identifier used for the run.

    • environment string enum enum

      Bubble environment used by the run. Allowed values: live, test.

    • summary string | null

      Summary text produced for the run.

    • testName string

      Human-readable name of the test.

    • groupRunId string | null

      Opaque identifier for the grouped project test run.

    • startedAt number | null

      Unix timestamp in milliseconds when the resource started running.

    • completedAt number | null

      Unix timestamp in milliseconds when the resource completed.

    • appBaseUrl string | null

      Base URL of the Bubble app used for the run when available.

    • bubbleAppName string | null

      Bubble app ID for the run when available.

    • assignedTestUser anyOf

      Detailed test-user assignment for the run.

      + Show Child Attributes
      • anyOf options 2 variants anyOf

        One or more options can apply.

        + Show Child Attributes
        • option 1 object
          + Show Child Attributes
          • id string

            Opaque identifier for this resource.

          • name string

            Human-readable name for the resource.

          • email string | null

            Email address associated with the resource.

          • database string enum enum

            Which Bubble database the credential should use. Allowed values: test, live.

        • option 2 null
    • counts object

      Aggregate counts for child or step statuses.

      + Show Child Attributes
      • total number

        Total number of items included in the count.

      • pending number

        Number of items still pending.

      • passed number

        Number of items that passed.

      • warning number

        Number of items that completed with warnings.

      • error number

        Number of items that failed with errors.

      • cancelled number

        Number of items that were canceled.

    • nextPendingStepId string | null

      Identifier of the next pending step, if one exists.

    • artifacts[] object array

      Artifacts captured for the run or step.

      + Show Child Attributes
      • id string

        Opaque identifier for this resource.

      • kind string enum enum

        Discriminator describing the kind of object returned. Allowed values: screenshot, video.

      • url string | null

        Absolute URL for the resource when available.

      • contentType string | null

        MIME type associated with the resource when available.

      • sizeBytes number | null

        Size of the resource in bytes when available.

      • createdAt number

        Unix timestamp in milliseconds when the resource was created.

  • test anyOf

    Test definition snapshot associated with the run, if it still exists.

    + Show Child Attributes
    • anyOf options 2 variants anyOf

      One or more options can apply.

      + Show Child Attributes
      • option 1 object
        + Show Child Attributes
        • id string

          Opaque identifier for this resource.

        • name string

          Human-readable name for the resource.

        • description string | null

          Human-readable description for the resource.

      • option 2 null
  • steps[] object array

    Ordered step results captured for the run.

    + Show Child Attributes
    • id string

      Opaque identifier for this resource.

    • position number

      Zero-based position of the item within its ordered collection.

    • sourceKind string enum enum

      Whether the run step originated from a direct step or a component. Allowed values: step, component.

    • sourceComponentId string | null

      Component test identifier that produced the run step when applicable.

    • sourceComponentName string | null

      Component test name that produced the run step when applicable.

    • instruction string

      Instruction for the step.

    • details string | null

      Optional extra detail for the step.

    • onFailure string enum enum

      Whether a run should stop immediately or continue when this step fails. Allowed values: stop, continue.

    • status string enum enum

      Current lifecycle status for the resource. 6 allowed enum values.

    • comment string | null

      Operator comment recorded for the step result.

    • completedAt number | null

      Unix timestamp in milliseconds when the resource completed.

    • artifacts[] object array

      Artifacts captured for the run or step.

      + Show Child Attributes
      • id string

        Opaque identifier for this resource.

      • kind string enum enum

        Discriminator describing the kind of object returned. Allowed values: screenshot, video.

      • url string | null

        Absolute URL for the resource when available.

      • contentType string | null

        MIME type associated with the resource when available.

      • sizeBytes number | null

        Size of the resource in bytes when available.

      • createdAt number

        Unix timestamp in milliseconds when the resource was created.