Skip to main content
POST
Create an async job

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code flow with PKCE, issued by the Michelangelo identity provider. Third-party clients register via Dynamic Client Registration — see the Authentication guide for the full flow.

Body

application/json
type
enum<string>
required

Job kind. Only prompt in v0.1; grows with the runner catalog

Available options:
prompt
input
object
required

Job-specific payload (e.g. the prompt text and options). model and appName are optional: when omitted the API evaluates the prompt server-side and fills them in before the runner picks up the job.

project_id
integer<int64>

Numeric project id (matches public.projects.id)

Response

Job accepted and queued

id
string<uuid>
required
type
string
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed,
canceled
created_at
string<date-time>
required
project_id
integer<int64>

Numeric project id (matches public.projects.id), nullable

result
object

Output payload on success — contains project_id and files_saved

error
object
updated_at
string<date-time>