Admin Agentic Jobs Endpoints¶

Admin Agentic Jobs API endpoints.

Overview¶

Method	Endpoint	Description
GET	`/api/v1/admin/agentic-jobs/`	Read Agentic Generation Jobs
GET	`/api/v1/admin/agentic-jobs/groups`	Read Agentic Generation Groups
GET	`/api/v1/admin/agentic-jobs/groups/{group_id}`	Read Agentic Generation Group
POST	`/api/v1/admin/agentic-jobs/production-requests/{production_request_id}/start`	Start Admin Agentic Generation Job
GET	`/api/v1/admin/agentic-jobs/{session_id}`	Read Agentic Generation Job

API Reference¶

Sartiq Backend Server - Admin Agentic Jobs 0.1.0¶

admin-agentic-jobs¶

POST /api/v1/admin/agentic-jobs/production-requests/{production_request_id}/start¶

Start Admin Agentic Generation Job

Description

Start a superuser-only agentic run, ignoring the configured generation mode.

Input parameters

Parameter	In	Type	Default	Nullable	Description
`OAuth2PasswordBearer`	header	string	N/A	No
`production_request_id`	path	string		No

Request body

application/json

Schema of the request body

{
    "anyOf": [
        {
            "$ref": "#/components/schemas/StartAgenticGenerationJobRequest"
        },
        {
            "type": "null"
        }
    ],
    "title": "Request In"
}

Responses

202 Accepted422 Unprocessable Entity

application/json

{
    "group_id": "78df7d9c-7f1c-48cb-9d91-e53cb2b9452f",
    "production_request_id": "f1e87673-4f21-4b69-8011-ed49ed96d4aa",
    "generations_per_shot_type": 0
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "group_id": {
            "type": "string",
            "format": "uuid",
            "title": "Group Id"
        },
        "production_request_id": {
            "type": "string",
            "format": "uuid",
            "title": "Production Request Id"
        },
        "generations_per_shot_type": {
            "type": "integer",
            "title": "Generations Per Shot Type"
        }
    },
    "type": "object",
    "required": [
        "group_id",
        "production_request_id",
        "generations_per_shot_type"
    ],
    "title": "StartAgenticGenerationJobResponse",
    "description": "Durable per-shot fan-out provisioned for the requested run.\n\n``group_id`` identifies the ``AgentSessionGroup`` aggregating the one-member-per-shot\nsessions (previously a single session_id)."
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string",
            "input": null,
            "ctx": {}
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

GET /api/v1/admin/agentic-jobs/¶

Read Agentic Generation Jobs

Description

List agentic generation jobs, newest first.

Input parameters

Parameter	In	Type	Default	Nullable
`OAuth2PasswordBearer`	header	string	N/A	No
`limit`	query	integer	20	No
`organization_id`	query			No
`skip`	query	integer	0	No
`status`	query			No

Responses

200 OK422 Unprocessable Entity

application/json

⚠️ This example has been generated automatically href="#__codelineno-5-1">{ "data": [ { "id": "50c4d29a-ab18-47f8-ab38-aa44f5c4eae0", "status": "string", "family": "string", "kind": "string", "organization_id": "2fa96618-bbde-4e86-b632-0a9c7cf57b19", "transport_ref": null, "group_id": null, "created_at": "2022-04-13T15:42:05.901Z", "updated_at": "2022-04-13T15:42:05.901Z", "completed_at": null, "processing_at": null, "recovery_attempts": 0, "job": {}, "submissions_count": 0, "has_result": true, "message_history_count": 0, "terminal_failure": null, "last_retryable_failure": null } ], "count": 0, "total": 0 } from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "data": {
            "items": {
                "$ref": "#/components/schemas/AgenticGenerationJobSummary"
            },
            "type": "array",
            "title": "Data"
        },
        "count": {
            "type": "integer",
            "title": "Count"
        },
        "total": {
            "type": "integer",
            "title": "Total"
        }
    },
    "type": "object",
    "required": [
        "data",
        "count",
        "total"
    ],
    "title": "AgenticGenerationJobsPublic",
    "description": "Paginated list response."
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string",
            "input": null,
            "ctx": {}
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

GET /api/v1/admin/agentic-jobs/groups¶

Read Agentic Generation Groups

Description

List PR-level agentic generation groups, newest first.

Input parameters

Parameter	In	Type	Default	Nullable
`OAuth2PasswordBearer`	header	string	N/A	No
`limit`	query	integer	20	No
`organization_id`	query			No
`production_request_id`	query			No
`skip`	query	integer	0	No

Responses

200 OK422 Unprocessable Entity

application/json

{
    "data": [
        {
            "id": "74c80f3e-3271-49ea-a469-0fd3387a730d",
            "organization_id": "ae9ecd45-f399-46ed-bfa3-c2d41eb0db1d",
            "production_request_id": "b40aa62a-3107-43e6-8345-91f1da75412c",
            "trigger": "string",
            "status": "string",
            "expected_count": 0,
            "completed_count": 0,
            "abandoned_count": 0,
            "in_progress_count": 0,
            "created_at": "2022-04-13T15:42:05.901Z",
            "updated_at": "2022-04-13T15:42:05.901Z",
            "completed_at": null,
            "failure_summaries": [
                {
                    "code": "string",
                    "stage": "string",
                    "message": "string",
                    "suggested_action": null
                }
            ]
        }
    ],
    "count": 0,
    "total": 0
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "data": {
            "items": {
                "$ref": "#/components/schemas/AgenticGenerationGroupSummary"
            },
            "type": "array",
            "title": "Data"
        },
        "count": {
            "type": "integer",
            "title": "Count"
        },
        "total": {
            "type": "integer",
            "title": "Total"
        }
    },
    "type": "object",
    "required": [
        "data",
        "count",
        "total"
    ],
    "title": "AgenticGenerationGroupsPublic",
    "description": "Paginated group list response."
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string",
            "input": null,
            "ctx": {}
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

GET /api/v1/admin/agentic-jobs/groups/{group_id}¶

Read Agentic Generation Group

Description

Full detail of one agentic generation group and its member sessions.

Input parameters

Parameter	In	Type	Default	Nullable	Description
`OAuth2PasswordBearer`	header	string	N/A	No
`group_id`	path	string		No

Responses

200 OK422 Unprocessable Entity

application/json

{
    "id": "1dda9411-c6f0-4e26-aa49-246bea28e437",
    "organization_id": "a2398f1f-dff6-422c-93d9-d269d70e0def",
    "production_request_id": "6cd99051-aadb-4b85-b08d-421301ef2704",
    "trigger": "string",
    "status": "string",
    "expected_count": 0,
    "created_at": "2022-04-13T15:42:05.901Z",
    "updated_at": "2022-04-13T15:42:05.901Z",
    "completed_at": null,
    "members": [
        {
            "id": "ff36feb7-8462-411d-864a-df04c6e018da",
            "status": "string",
            "family": "string",
            "kind": "string",
            "organization_id": "7422834b-e6fc-4ed7-b8fc-d292bd95c0a8",
            "transport_ref": null,
            "group_id": null,
            "created_at": "2022-04-13T15:42:05.901Z",
            "updated_at": "2022-04-13T15:42:05.901Z",
            "completed_at": null,
            "processing_at": null,
            "recovery_attempts": 0,
            "job": {},
            "submissions_count": 0,
            "has_result": true,
            "message_history_count": 0,
            "terminal_failure": null,
            "last_retryable_failure": null
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
        },
        "organization_id": {
            "type": "string",
            "format": "uuid",
            "title": "Organization Id"
        },
        "production_request_id": {
            "type": "string",
            "format": "uuid",
            "title": "Production Request Id"
        },
        "trigger": {
            "type": "string",
            "title": "Trigger"
        },
        "status": {
            "type": "string",
            "title": "Status"
        },
        "expected_count": {
            "type": "integer",
            "title": "Expected Count"
        },
        "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
        },
        "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At"
        },
        "completed_at": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Completed At"
        },
        "members": {
            "items": {
                "$ref": "#/components/schemas/AgenticGenerationJobSummary"
            },
            "type": "array",
            "title": "Members"
        }
    },
    "type": "object",
    "required": [
        "id",
        "organization_id",
        "production_request_id",
        "trigger",
        "status",
        "expected_count",
        "created_at",
        "updated_at",
        "members"
    ],
    "title": "AgenticGenerationGroupDetail",
    "description": "Full group detail: aggregate counts plus the member sessions."
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string",
            "input": null,
            "ctx": {}
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

GET /api/v1/admin/agentic-jobs/{session_id}¶

Read Agentic Generation Job

Input parameters

Parameter	In	Type	Default	Nullable	Description
`OAuth2PasswordBearer`	header	string	N/A	No
`session_id`	path	string		No

Responses

200 OK422 Unprocessable Entity

application/json

{
    "id": "4f5f5974-3325-476e-8dfc-c1da1faab2a4",
    "status": "string",
    "family": "string",
    "kind": "string",
    "organization_id": "0c82c76f-6071-458d-a949-ae4d96ff3292",
    "transport_ref": null,
    "group_id": null,
    "created_at": "2022-04-13T15:42:05.901Z",
    "updated_at": "2022-04-13T15:42:05.901Z",
    "completed_at": null,
    "processing_at": null,
    "recovery_attempts": 0,
    "job": {},
    "submissions": {},
    "planning_context_fingerprint": null,
    "evidence_storage_keys": {},
    "planning_diagnostics": [
        {}
    ],
    "run_metrics": [
        {}
    ],
    "tool_events": [
        {}
    ],
    "thinking": [
        {}
    ],
    "result": null,
    "message_history": [
        null
    ],
    "message_history_count": 0,
    "terminal_failure": null,
    "last_retryable_failure": null
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
        },
        "status": {
            "type": "string",
            "title": "Status"
        },
        "family": {
            "type": "string",
            "title": "Family"
        },
        "kind": {
            "type": "string",
            "title": "Kind"
        },
        "organization_id": {
            "type": "string",
            "format": "uuid",
            "title": "Organization Id"
        },
        "transport_ref": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "uuid"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Transport Ref"
        },
        "group_id": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "uuid"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Group Id"
        },
        "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
        },
        "updated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Updated At"
        },
        "completed_at": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Completed At"
        },
        "processing_at": {
            "anyOf": [
                {
                    "type": "string",
                    "format": "date-time"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Processing At"
        },
        "recovery_attempts": {
            "type": "integer",
            "title": "Recovery Attempts",
            "default": 0
        },
        "job": {
            "additionalProperties": true,
            "type": "object",
            "title": "Job",
            "default": {}
        },
        "submissions": {
            "additionalProperties": true,
            "type": "object",
            "title": "Submissions",
            "default": {}
        },
        "planning_context_fingerprint": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Planning Context Fingerprint"
        },
        "evidence_storage_keys": {
            "additionalProperties": true,
            "type": "object",
            "title": "Evidence Storage Keys",
            "default": {}
        },
        "planning_diagnostics": {
            "items": {
                "additionalProperties": true,
                "type": "object"
            },
            "type": "array",
            "title": "Planning Diagnostics",
            "default": []
        },
        "run_metrics": {
            "items": {
                "additionalProperties": true,
                "type": "object"
            },
            "type": "array",
            "title": "Run Metrics",
            "default": []
        },
        "tool_events": {
            "items": {
                "additionalProperties": true,
                "type": "object"
            },
            "type": "array",
            "title": "Tool Events",
            "default": []
        },
        "thinking": {
            "items": {
                "additionalProperties": true,
                "type": "object"
            },
            "type": "array",
            "title": "Thinking",
            "default": []
        },
        "result": {
            "anyOf": [
                {
                    "additionalProperties": true,
                    "type": "object"
                },
                {
                    "type": "null"
                }
            ],
            "title": "Result"
        },
        "message_history": {
            "items": {},
            "type": "array",
            "title": "Message History",
            "default": []
        },
        "message_history_count": {
            "type": "integer",
            "title": "Message History Count",
            "default": 0
        },
        "terminal_failure": {
            "anyOf": [
                {
                    "$ref": "#/components/schemas/AgenticGenerationFailurePublic"
                },
                {
                    "type": "null"
                }
            ]
        },
        "last_retryable_failure": {
            "anyOf": [
                {
                    "$ref": "#/components/schemas/AgenticGenerationFailurePublic"
                },
                {
                    "type": "null"
                }
            ]
        }
    },
    "type": "object",
    "required": [
        "id",
        "status",
        "family",
        "kind",
        "organization_id",
        "created_at",
        "updated_at"
    ],
    "title": "AgenticGenerationJobDetail",
    "description": "Full detail: includes result (plan), message history, and state."
}

application/json

{
    "detail": [
        {
            "loc": [
                null
            ],
            "msg": "string",
            "type": "string",
            "input": null,
            "ctx": {}
        }
    ]
}

⚠️ This example has been generated automatically from the schema and it is not accurate. Refer to the schema for more information.

Schema of the response body

{
    "properties": {
        "detail": {
            "items": {
                "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
        }
    },
    "type": "object",
    "title": "HTTPValidationError"
}

Schemas¶

AgenticGenerationFailurePublic¶

Name	Type	Description
`code`	string
`message`	string
`stage`	string
`suggested_action`

AgenticGenerationGroupDetail¶

Name	Type	Description
`completed_at`
`created_at`	string(date-time)
`expected_count`	integer
`id`	string(uuid)
`members`	Array<AgenticGenerationJobSummary>
`organization_id`	string(uuid)
`production_request_id`	string(uuid)
`status`	string
`trigger`	string
`updated_at`	string(date-time)

AgenticGenerationGroupsPublic¶

Name	Type	Description
`count`	integer
`data`	Array<AgenticGenerationGroupSummary>
`total`	integer

AgenticGenerationGroupSummary¶

Name	Type	Description
`abandoned_count`	integer
`completed_at`
`completed_count`	integer
`created_at`	string(date-time)
`expected_count`	integer
`failure_summaries`	Array<AgenticGenerationFailurePublic>
`id`	string(uuid)
`in_progress_count`	integer
`organization_id`	string(uuid)
`production_request_id`	string(uuid)
`status`	string
`trigger`	string
`updated_at`	string(date-time)

AgenticGenerationJobDetail¶

Name	Type	Description
`completed_at`
`created_at`	string(date-time)
`evidence_storage_keys`
`family`	string
`group_id`
`id`	string(uuid)
`job`
`kind`	string
`last_retryable_failure`
`message_history`	Array<>
`message_history_count`	integer
`organization_id`	string(uuid)
`planning_context_fingerprint`
`planning_diagnostics`	Array<>
`processing_at`
`recovery_attempts`	integer
`result`
`run_metrics`	Array<>
`status`	string
`submissions`
`terminal_failure`
`thinking`	Array<>
`tool_events`	Array<>
`transport_ref`
`updated_at`	string(date-time)

AgenticGenerationJobsPublic¶

Name	Type	Description
`count`	integer
`data`	Array<AgenticGenerationJobSummary>
`total`	integer

AgenticGenerationJobSummary¶

Name	Type	Description
`completed_at`
`created_at`	string(date-time)
`family`	string
`group_id`
`has_result`	boolean
`id`	string(uuid)
`job`
`kind`	string
`last_retryable_failure`
`message_history_count`	integer
`organization_id`	string(uuid)
`processing_at`
`recovery_attempts`	integer
`status`	string
`submissions_count`	integer
`terminal_failure`
`transport_ref`
`updated_at`	string(date-time)

AgentSessionStatus¶

Type: string

HTTPValidationError¶

Name	Type	Description
`detail`	Array<ValidationError>

StartAgenticGenerationJobRequest¶

Name	Type	Description
`generations_per_shot_type`	integer
`shot_id`		Optional exact shot to generate; omit to fan out over the production request.
`system_prompt_override`		Optional complete replacement for the autonomous planner system prompt.

StartAgenticGenerationJobResponse¶

Name	Type	Description
`generations_per_shot_type`	integer
`group_id`	string(uuid)
`production_request_id`	string(uuid)

ValidationError¶

Name	Type	Description
`ctx`
`input`
`loc`	Array<>
`msg`	string
`type`	string

Security schemes¶

Name	Type	Scheme	Description
OAuth2PasswordBearer	oauth2