curl --request GET \
--url https://api.geekidea.ai/v1/workflow_runs/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.geekidea.ai/v1/workflow_runs/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.geekidea.ai/v1/workflow_runs/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "run_0192f1c3a7b87c3e9a4f5b6c7d8e9f01",
"object": "workflow.run",
"workflow": "geekidea/drama-episode",
"status": "running",
"progress": 40,
"auto_continue": true,
"budget_usd": 123,
"model_cost_usd": 123,
"fee_usd": 123,
"cost_usd": 123,
"held_usd": 123,
"error_code": "<string>",
"steps": [
{
"key": "storyboard",
"status": "succeeded",
"attempt": 1,
"error_code": "workflow_charge_exhausted",
"started_at": 123,
"finished_at": 123,
"confirmed_at": 123
}
],
"created_at": 123,
"finished_at": 123
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}Retrieve a workflow run
Returns the run with its steps and costs. Costs are the model cost of the calls made by the steps (at your organization’s rates) plus the per-step workflow fee; both are settled per segment, so model_cost_usd, fee_usd and cost_usd only include finished segments, and held_usd is the amount held for the segment in progress.
curl --request GET \
--url https://api.geekidea.ai/v1/workflow_runs/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.geekidea.ai/v1/workflow_runs/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.geekidea.ai/v1/workflow_runs/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "run_0192f1c3a7b87c3e9a4f5b6c7d8e9f01",
"object": "workflow.run",
"workflow": "geekidea/drama-episode",
"status": "running",
"progress": 40,
"auto_continue": true,
"budget_usd": 123,
"model_cost_usd": 123,
"fee_usd": 123,
"cost_usd": 123,
"held_usd": 123,
"error_code": "<string>",
"steps": [
{
"key": "storyboard",
"status": "succeeded",
"attempt": 1,
"error_code": "workflow_charge_exhausted",
"started_at": 123,
"finished_at": 123,
"confirmed_at": 123
}
],
"created_at": 123,
"finished_at": 123
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}{
"error": {
"message": "The model does not exist or you do not have access to it.",
"type": "not_found_error",
"param": "model",
"code": "model_not_found",
"retryable": false,
"errors": [
{
"param": "messages",
"code": "missing_parameter",
"message": "<string>"
}
]
}
}Authorizations
Provide your API key in the Authorization header using Bearer auth
Path Parameters
Run ID returned when the workflow was started
Response
OK
A workflow run
Run ID (run_ prefix)
"run_0192f1c3a7b87c3e9a4f5b6c7d8e9f01"
Object type, always workflow.run
"workflow.run"
Workflow ID
"geekidea/drama-episode"
Status: pending / running / waiting_input / succeeded / failed / cancelled
pending, running, waiting_input, succeeded, failed, cancelled "running"
Progress (0–100)
40
Whether steps continue without confirmation
Budget of the whole run (USD); null when unlimited
Settled model cost (USD)
Settled workflow fee (USD)
Settled charge (USD)
Amount held for the segment in progress (USD); null when nothing is running
Error code when the run failed
Steps
Show child attributes
Show child attributes
Creation time (Unix seconds)
Finish time (Unix seconds); null when not finished
