Get Run Provenance

curl --request GET \
  --url https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "editInstruction": "<string>",
  "programCommitId": "<string>",
  "programFunctionId": "<string>",
  "programId": "<string>",
  "programInput": "<string>",
  "programSource": "<string>",
  "sources": [
    {
      "componentId": "<string>",
      "count": "<string>",
      "kind": "<string>",
      "label": "<string>",
      "matchedToolCall": "<string>",
      "ref": "<string>",
      "verified": true
    }
  ],
  "steps": [
    {
      "objects": [
        {
          "displayName": "<string>",
          "id": "<string>",
          "recordType": "A2UI_PROVENANCE_RECORD_TYPE_UNSPECIFIED"
        }
      ],
      "operation": "A2UI_PROVENANCE_OPERATION_UNSPECIFIED",
      "recordType": "A2UI_PROVENANCE_RECORD_TYPE_UNSPECIFIED"
    }
  ],
  "stepsAvailable": true
}

GET

api

reporting

reports

{id}

runs

{run_id}

provenance

Get Run Provenance

curl --request GET \
  --url https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://{tenantDomain}.conductor.one/api/v1/reporting/reports/{id}/runs/{run_id}/provenance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "editInstruction": "<string>",
  "programCommitId": "<string>",
  "programFunctionId": "<string>",
  "programId": "<string>",
  "programInput": "<string>",
  "programSource": "<string>",
  "sources": [
    {
      "componentId": "<string>",
      "count": "<string>",
      "kind": "<string>",
      "label": "<string>",
      "matchedToolCall": "<string>",
      "ref": "<string>",
      "verified": true
    }
  ],
  "steps": [
    {
      "objects": [
        {
          "displayName": "<string>",
          "id": "<string>",
          "recordType": "A2UI_PROVENANCE_RECORD_TYPE_UNSPECIFIED"
        }
      ],
      "operation": "A2UI_PROVENANCE_OPERATION_UNSPECIFIED",
      "recordType": "A2UI_PROVENANCE_RECORD_TYPE_UNSPECIFIED"
    }
  ],
  "stepsAvailable": true
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization

string

header

required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Path Parameters

string

required

The id field.

run_id

string

required

The runId field.

Response

200 - application/json

Successful response

The ReportingServiceGetRunProvenanceResponse message.

editInstruction

string

The immutable user instruction that produced an applied edit.

programCommitId

string

deprecated

The programCommitId field.

programFunctionId

string

deprecated

Deprecated tombstones. Source-owned reports never populate Function or commit identity; these declarations remain only because c1api forbids deleting published fields.

programId

string

The durable source version this run pinned.

programInput

string

The parameters this run was bound to, as JSON. "{}" for a program that takes none — a real answer, distinct from absent.

programSource

string

The programSource field.

sources

A 2 Ui Provenance Source · object[] | null

What each part of the report shows, read off the run's own copy of the surface rather than a live one.

Show child attributes

steps

A 2 Ui Provenance Step · object[] | null

What the program looked at, derived from its source.

Show child attributes

stepsAvailable

boolean

False when the program's source could not be read, which is what makes an empty steps list mean "unknown" rather than "it read nothing".

Welcome

Endpoints

Get Run Provenance

Authorizations

Path Parameters

Response