Skip to main content
POST
Create Desktop Approval

Authorizations

Authorization
string
header
required

API key from Settings > Developer > REST API

Headers

Moda-Version
enum<string>
default:2026-05-01

Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.

Available options:
2026-04-12,
2026-05-01
Example:

"2026-05-01"

Body

application/json
computer_id
string<uuid>
required
operation
string
required

The Studio operation id, e.g. mediaGenerateImage

Required string length: 1 - 64
max_credits
integer
required

The most this job may hold or be charged

Required range: 1 <= x <= 1000000
request
Request · object | null

The exact JSON body the computer will send; Studio computes the fingerprint

fingerprint
string | null

Instead of request: its fingerprint (sha256:), computed per the contract

Response

Successful Response

approval_id
string
required
fingerprint
string
required
operation
string
required
computer_id
string<uuid>
required
max_credits
integer
required
expires_at
string<date-time>
required