REST API specification
Generated from the checked-in source. Do not edit this reference by hand.
Download the full OpenAPI JSON. Authentication, parameters, request bodies and response schemas below come from that same contract.
The contract includes endpoints with explicit limitations or stub status. Read the scope on each operation.
Model APIs
Section titled “Model APIs”GET /v1/branding— Read public branding and theme defaultsPOST /v1/chat/completions— Create an OpenAI-compatible chat completionGET /v1/currency— Read the configured platform currencyPOST /v1/embeddings— Create OpenAI-compatible text embeddingsGET /v1/generations/{id}— Get generation usage, latency, and customer charge by IDGET /v1/key— Inspect the current workspace API keyPOST /v1/messages— Create a native text Message, optionally streamedGET /v1/models— List key-accessible model aliases and workspace customer pricesPOST /v1/responses— Create a text responsePOST /v1beta/models/{model_action}— Generate native buffered Gemini text
Video and media APIs
Section titled “Video and media APIs”GET /v1/media/assets— List saved workspace Provider assetsPOST /v1/media/assets— Create a Provider asset from a URLDELETE /v1/media/assets/{id}— Delete a Provider assetGET /v1/media/assets/{id}— Read a saved Provider assetPATCH /v1/media/assets/{id}— Rename a Provider assetPOST /v1/media/assets/{id}/refresh— Refresh one owned Provider assetGET /v1/media/capabilities— Discover authorized model-specific native Provider toolsGET /v1/media/groups— List saved workspace Provider groupsPOST /v1/media/groups— Create a Provider asset groupDELETE /v1/media/groups/{id}— Delete a Provider asset groupGET /v1/media/groups/{id}— Read a saved Provider groupPATCH /v1/media/groups/{id}— Update Provider group metadataPOST /v1/media/groups/{id}/refresh— Refresh one owned Provider groupGET /v1/media/image-ingestions— Recover this API key’s saved ingestion historyDELETE /v1/media/image-ingestions/{id}— Revoke source publication consent without erasing immutable historyGET /v1/media/image-ingestions/{id}— Read customer-safe ingestion status under the original API keyPUT /v1/media/image-ingestions/{id}— Consent to ingestion of one inspected image into one ordinary asset groupPOST /v1/media/image-ingestions/{id}/dispatch— Claim and dispatch one inspected image ingestionGET /v1/media/image-ingestions/{id}/readiness/{read_id}— Retrieve one persisted readiness observation without an upstream requestPOST /v1/media/image-ingestions/{id}/readiness/{read_id}— Observe accepted image status using its original accountPOST /v1/media/image-sources— Inspect and temporarily retain one exact inline imageDELETE /v1/media/image-sources/{id}— Erase this API key’s retained source bytesGET /v1/media/operations— List saved Provider mutation operationsGET /v1/media/operations/{id}— Read a saved Provider mutation operationPOST /v1/media/operations/{id}/cancel— Cancel an unclaimed native material preparationPOST /v1/media/operations/{id}/dispatch— Explicitly dispatch an existing native material preparationGET /v1/media/operations/by-idempotency/{id}— Read a saved Provider operation by request idempotency UUIDPOST /v1/media/operations/prepare— Prepare a native material operation without dispatchGET /v1/media/sources/{token}— Fetch exact approved image bytes using an expiring capabilityHEAD /v1/media/sources/{token}— Reject HEAD probes of image source capabilitiesGET /v1/media/verifications— List saved verification sessionsPOST /v1/media/verifications— Create upstream human verification sessionGET /v1/media/verifications/{id}— Read saved verification sessionGET /v1/media/verifications/{id}/link— Get authenticated upstream verification linkPOST /v1/media/verifications/{id}/refresh— Refresh upstream verification sessionPOST /v1/video/estimate— Estimate a configured text-video request without submissionGET /v1/video/jobs— List durable workspace video jobsPOST /v1/video/jobs— Submit a schema-validated video jobGET /v1/video/jobs/{id}— Read persisted video job stateGET /v1/video/jobs/{id}/billing— Read saved customer video billingGET /v1/video/jobs/{id}/observations— Read saved video query observationsPOST /v1/video/jobs/{id}/refresh— Refresh one direct-channel video jobDELETE /v1/video/jobs/{id}/results— Permanently remove locally saved result referencesGET /v1/video/jobs/{id}/results— Read saved result availability without downloading mediaGET /v1/video/jobs/{id}/results/{kind}— Retrieve a bounded saved video or last framePOST /v1/video/jobs/{id}/results/{kind}/refresh— Retrieve fresh output from the original Video taskGET /v1/video/jobs/{id}/timings— Read measured gateway video transport spansGET /v1/video/models— Read customer-safe configured text-video capabilities
Providers and routing APIs
Section titled “Providers and routing APIs”GET /api/v1/pools— List platform-managed model route poolsPUT /api/v1/pools— Create or revise a model candidate poolGET /api/v1/pools/{reference}— Read an installation-managed model candidate poolGET /api/v1/pools/{reference}/audit— Audit routing and billing strategy for a model route poolGET /api/v1/pools/{reference}/history— Read immutable model candidate pool revisionsPOST /api/v1/pools/{reference}/preview— Dry-run routing preview for a model route poolGET /api/v1/pools/history— Read immutable model candidate pool revisionsGET /api/v1/pools/index— List platform-managed model route poolsGET /api/v1/provider-memberships— List the signed-in operator’s complete active Provider membershipsGET /api/v1/providers— List active Provider business identitiesPOST /api/v1/providers— Create a Provider business identityDELETE /api/v1/providers/{provider}— Remove an unconfigured Provider from the directoryGET /api/v1/providers/{provider}— Read Provider business profilePATCH /api/v1/providers/{provider}— Update Provider business profileGET /api/v1/providers/{provider}/administration— Explicit installation oversight of the Provider dashboardGET /api/v1/providers/{provider}/configuration-usage— Inspect operational usage of Provider-owned configurationsGET /api/v1/providers/{provider}/dashboard— Provider-scoped earnings and operations; active explicit membership requiredGET /api/v1/providers/{provider}/earnings— Page platform Provider accrued and paid obligationsGET /api/v1/providers/{provider}/integration— Read provider integration identityPUT /api/v1/providers/{provider}/integration— Set provider integration identityGET /api/v1/providers/{provider}/media-offer-models— List named draft media offer bindingsPOST /api/v1/providers/{provider}/media-offers— Save an inactive versioned media offer without text-token pricesGET /api/v1/providers/{provider}/media-rate-models— List current media pricing configuration choicesGET /api/v1/providers/{provider}/media-rates— Read this Provider’s agreed media purchase schedulesPOST /api/v1/providers/{provider}/media-rates— Publish confidential agreed Provider media purchase termsPOST /api/v1/providers/{provider}/media-rates/{revision}/retire— End a Provider purchase schedule’s eligibilityPOST /api/v1/providers/{provider}/media-rates/replace— Atomically replace agreed media purchase termsGET /api/v1/providers/{provider}/members— List Provider business membersPUT /api/v1/providers/{provider}/members/{operator}— Grant, change or disable a Provider membershipGET /api/v1/providers/{provider}/offers— Page current Provider offers and rate revisionsPOST /api/v1/providers/{provider}/offers— Publish an immutable agreed Provider payout schedulePATCH /api/v1/providers/{provider}/offers/{offer}— A Provider manager can pause or resume an owned offerPUT /api/v1/providers/{provider}/offers/{offer}/qualification— Record a Provider offer qualification reviewPOST /api/v1/providers/{provider}/offers/{offer}/qualification/revoke— Revoke the current Provider offer qualificationGET /api/v1/providers/{provider}/offers/{offer}/revisions— List immutable Provider quote historyGET /api/v1/providers/{provider}/offers/{offer}/revisions/{revision}— Read an immutable Provider procurement quotePUT /api/v1/providers/{provider}/qualification— Record a Provider business qualification reviewPOST /api/v1/providers/{provider}/qualification/revoke— Revoke the current Provider business qualificationGET /api/v1/providers/{provider}/settlements— Page Provider settlement historyPOST /api/v1/providers/{provider}/settlements— Record an already completed external Provider paymentGET /api/v1/providers/{supplier}/offers/{offer}/media-liability-bounds— List immutable route media liability qualificationsPOST /api/v1/providers/{supplier}/offers/{offer}/media-liability-bounds— Publish an evidenced route media liability boundPOST /api/v1/providers/{supplier}/offers/{offer}/media-liability-bounds/{revision}/retire— Retire a route media liability boundGET /api/v1/routing-registry— Read the active routing generationGET /api/v1/vendors— List Provider API-key configurations without credentialsPOST /api/v1/vendors— Create an encrypted Provider API-key configurationPUT /api/v1/vendors/{id}— Update one Provider API-key configuration or rotate its credentialDELETE /api/v1/vendors/{id}/asset-management— Revoke locally saved asset-management credentialsGET /api/v1/vendors/{id}/asset-management— Read installation asset-management configuration metadataPUT /api/v1/vendors/{id}/asset-management— Save an encrypted asset-management credential revisionGET /api/v1/vendors/{id}/asset-management/authorizations— List one account’s qualification recordsPOST /api/v1/vendors/{id}/asset-management/authorizations— Record administrator-reviewed ordinary asset qualificationDELETE /api/v1/vendors/{id}/asset-management/authorizations/{authorization}— Revoke one account’s asset qualificationPOST /api/v1/vendors/{id}/asset-management/group-deletion-consents— Record specific cascading-deletion consent without dispatchDELETE /api/v1/vendors/{id}/asset-management/group-deletion-consents/{consent}— Revoke local deletion consent without erasing historyGET /api/v1/vendors/{id}/asset-management/group-deletion-consents/{consent}— Read safe local consent and outcome statusPOST /api/v1/vendors/{id}/asset-management/group-deletion-consents/{consent}/dispatch— Dispatch one irreversible ordinary-group cascading deletionGET /api/v1/vendors/{id}/asset-management/group-reads— List scoped ordinary group-read outcomes and timingPOST /api/v1/vendors/{id}/asset-management/group-reads— Read a saved ordinary asset group using its original accountDELETE /api/v1/vendors/{id}/asset-management/group-reads/{read}— Erase retained group-read contentGET /api/v1/vendors/{id}/asset-management/group-reads/{read}— Recover an encrypted ordinary group read resultGET /api/v1/vendors/{id}/asset-management/group-updates— Retrieve scoped metadata-update audit historyPOST /api/v1/vendors/{id}/asset-management/group-updates— Prepare an encrypted metadata patch for a saved ordinary groupDELETE /api/v1/vendors/{id}/asset-management/group-updates/{update}— Erase retained metadata-update patchPOST /api/v1/vendors/{id}/asset-management/group-updates/{update}/dispatch— Dispatch a prepared ordinary-group metadata update oncePOST /api/v1/vendors/{id}/asset-management/group-updates/{update}/reconcile— Read back and reconcile an acknowledged ordinary-group updatePOST /api/v1/vendors/{id}/asset-management/groups— Create an ordinary asset group through platform administrationGET /api/v1/vendors/{id}/asset-management/listings— List scoped ordinary asset-listing outcomes and timingPOST /api/v1/vendors/{id}/asset-management/listings— List one bounded page of assets in a saved ordinary groupDELETE /api/v1/vendors/{id}/asset-management/listings/{listing}— Erase retained ordinary asset listing contentGET /api/v1/vendors/{id}/asset-management/listings/{listing}— Recover a retained ordinary asset listing locallyGET /api/v1/vendors/{id}/asset-management/lookups— List durable asset lookup audit historyPOST /api/v1/vendors/{id}/asset-management/lookups— Look up one asset from a retained original-group listingDELETE /api/v1/vendors/{id}/asset-management/lookups/{lookup}— Erase retained asset lookup contentGET /api/v1/vendors/{id}/asset-management/lookups/{lookup}— Recover one encrypted asset lookup resultGET /api/v1/vendors/{id}/catalog— Discover upstream models for a Provider API-key configurationPOST /api/v1/vendors/{id}/catalog— Refresh descriptive metadata for existing vendor model mappingsPOST /api/v1/vendors/{id}/check— Check provider reachability and whether a mapped model is listedGET /api/v1/vendors/{id}/integration— Read vendor integration identityPUT /api/v1/vendors/{id}/integration— Set vendor integration identityGET /api/v1/vendors/{id}/models— List model bindings for one Provider API-key configurationPOST /api/v1/vendors/{id}/models— Create or update a model mapping with optimistic revision checksPUT /api/v1/vendors/{id}/personal-owner— Assign a configured personal credential to its accountGET /api/v1/vendors/{id}/supplier— Read the Provider owning an API configurationPUT /api/v1/vendors/{id}/supplier— Associate an API configuration with a ProviderGET /api/v1/vendors/{vendor}/cooldown— Read credential safe-failure cooldownGET /api/v1/vendors/{vendor}/request-rate-limit— Read upstream credential request limitPUT /api/v1/vendors/{vendor}/request-rate-limit— Set upstream credential request limitGET /api/v1/vendors/{vendor}/request-rate-limit/history— Read credential request-limit history
Authentication and sessions
Section titled “Authentication and sessions”POST /api/v1/auth/browser/demo— Sign in to the configured shared demo accountPOST /api/v1/auth/browser/login— Sign in with a secure HttpOnly member cookiePOST /api/v1/auth/browser/logout— Revoke and clear the current browser member sessionPOST /api/v1/auth/browser/token— Use an existing user access token in the browserGET /api/v1/auth/config— Discover member sign-in availabilityPOST /api/v1/auth/login— Exchange member credentials for a scoped eight-hour sessionPOST /api/v1/auth/logout— Sign out the member session supplied in AuthorizationPUT /api/v1/auth/password— Change the signed-in member’s password with current-password proofGET /api/v1/auth/preferences— Read current member appearance preferencePUT /api/v1/auth/preferences— Save current member appearance preferenceGET /api/v1/auth/profile— Read current member profilePUT /api/v1/auth/profile— Update current member profileGET /api/v1/operators— List operator identities without session credentialsPOST /api/v1/operators— Create an operator and issue its first session tokenDELETE /api/v1/operators/{operator}— Revoke an operator and all of its sessionsPATCH /api/v1/operators/{operator}— Change a scoped customer member roleGET /api/v1/operators/{operator}/events— Read immutable operator and session lifecycle eventsGET /api/v1/operators/{operator}/password— Read a member’s sign-in configurationPUT /api/v1/operators/{operator}/password— Provision or reset an existing member passwordGET /api/v1/operators/{operator}/sessions— List session expiry and revocation metadataPOST /api/v1/operators/{operator}/sessions— Issue an additional one-time operator session tokenDELETE /api/v1/operators/{operator}/sessions/{session}— Revoke one operator sessionGET /api/v1/session— Read the current administrator’s scope and permissions
Workspace and company APIs
Section titled “Workspace and company APIs”GET /api/v1/commercial-position— Compare installation commercial Provider positionsGET /api/v1/financial-summary— Read platform customer revenue and cash receipt summaryGET /api/v1/guardrails/detectors/{detector}— Read installation text detector processing declarationPOST /api/v1/guardrails/detectors/{detector}/preview— Preview installation text detector transportGET /api/v1/metrics— Read in-process request and token countersGET /api/v1/models— List configured model routesGET /api/v1/organizations— List authorized company metadataPOST /api/v1/organizations— Create a company and its initial zero-funded accountPOST /api/v1/organizations/{organization}/billing/accounts/{currency}/grants— Issue administrator noncash customer creditGET /api/v1/organizations/{organization}/billing/accounts/{currency}/grants/{grant}— Read one original noncash gift and its correctionPOST /api/v1/organizations/{organization}/billing/accounts/{currency}/grants/{grant}/correction— Correct a wholly unused noncash giftGET /api/v1/organizations/{organization}/billing/accounts/{currency}/grants/issued— List issued noncash gifts and correctionsPOST /api/v1/organizations/{organization}/billing/accounts/{currency}/grants/prepare— Prepare a durable noncash gift intentGET /api/v1/organizations/{organization}/billing/accounts/{currency}/grants/prepared— Recover saved noncash grant publication intentsGET /api/v1/organizations/{organization}/billing/accounts/{currency}/grants/prepared/{key}— Read original noncash gift intent by idempotency keyPUT /api/v1/organizations/{organization}/billing/accounts/{currency}/policy— Configure approved credit and low-balance thresholdGET /api/v1/organizations/{organization}/billing/accounts/{currency}/policy/history— Read immutable company credit and warning policy revisionsPUT /api/v1/organizations/{organization}/billing/accounts/{currency}/warning-threshold— Set company low-balance warning thresholdGET /api/v1/organizations/{organization}/billing/balance— Read shared company account balancesGET /api/v1/organizations/{organization}/billing/charge-reconciliation— Compare customer charge records with prepaid ledger debitsPOST /api/v1/organizations/{organization}/billing/entries/{entry}/reversal— Record a balance refund or settled-funding reversalPOST /api/v1/organizations/{organization}/billing/funding/settled— Record an externally verified settled customer paymentGET /api/v1/organizations/{organization}/billing/media-rate-models— Read named qualified commercial video configuration choicesGET /api/v1/organizations/{organization}/billing/media-rates— Read bounded immutable customer selling historyPOST /api/v1/organizations/{organization}/billing/media-rates— Publish an immutable customer video selling schedulePOST /api/v1/organizations/{organization}/billing/media-rates/{revision}/retire— End a published customer media rate’s eligibilityPOST /api/v1/organizations/{organization}/billing/media-rates/replace— Atomically replace a customer media selling scheduleGET /api/v1/organizations/{organization}/billing/payment-methods— Read company checkout availabilityPOST /api/v1/organizations/{organization}/billing/quotes— Prepare an exact versioned Credits purchase quoteGET /api/v1/organizations/{organization}/billing/quotes/{quote}— Read a saved Credits purchase quoteGET /api/v1/organizations/{organization}/billing/reservations— Inspect open customer balance reservationsGET /api/v1/organizations/{organization}/billing/topups— Recover company checkout historyPOST /api/v1/organizations/{organization}/billing/topups— Create or recover a company prepaid top-upGET /api/v1/organizations/{organization}/billing/topups/{order}— Read saved company top-up statusPOST /api/v1/organizations/{organization}/billing/topups/{order}/reconcile— Independently reconcile a saved paymentGET /api/v1/organizations/{organization}/billing/transactions— Read a company balance transaction pageGET /api/v1/organizations/{organization}/billing/units— Read exact Credits quantities by original definition and provenancePOST /api/v1/organizations/{organization}/billing/units/charges/{attempt}/refunds— Restore original consumed Credits rangesPOST /api/v1/organizations/{organization}/billing/units/grants— Issue noncash Credits with an immutable provenance and expiryGET /api/v1/organizations/{organization}/billing/units/purchases/{order}/reversals— Preview a Credits purchase reversal and read committed reversal receiptsPOST /api/v1/organizations/{organization}/billing/units/purchases/{order}/reversals— Reverse unoccupied Credits purchase ranges at processor minor-unit precisionGET /api/v1/organizations/{organization}/projects— List scoped company workspacesPOST /api/v1/organizations/{organization}/projects— Create a workspace in the selected companyDELETE /api/v1/organizations/{organization}/projects/{project}— Delete an empty workspacePATCH /api/v1/organizations/{organization}/projects/{project}— Rename a workspaceGET /api/v1/organizations/{organization}/projects/{project}/accounts— List account metadata without credential referencesPOST /api/v1/organizations/{organization}/projects/{project}/accounts— Register an unverified accountGET /api/v1/organizations/{organization}/projects/{project}/asset-group-intents— Discover saved asset group creation requestsDELETE /api/v1/organizations/{organization}/projects/{project}/asset-group-intents/{intent}/request— Delete saved asset-creation request contentGET /api/v1/organizations/{organization}/projects/{project}/asset-group-intents/{intent}/request— Read customer-safe asset request content and retention statusGET /api/v1/organizations/{organization}/projects/{project}/assets— List saved workspace materialsPOST /api/v1/organizations/{organization}/projects/{project}/assets— Save a workspace materialDELETE /api/v1/organizations/{organization}/projects/{project}/assets/{asset}— Delete a saved workspace materialGET /api/v1/organizations/{organization}/projects/{project}/assets/{asset}— Read workspace material metadataPATCH /api/v1/organizations/{organization}/projects/{project}/assets/{asset}— Rename a saved workspace materialGET /api/v1/organizations/{organization}/projects/{project}/assets/{asset}/content— Download saved workspace material bytesGET /api/v1/organizations/{organization}/projects/{project}/billing— Read workspace customer charges, tariffs and latest 100 invoicesGET /api/v1/organizations/{organization}/projects/{project}/billing/invoices— Page complete workspace customer invoice historyPOST /api/v1/organizations/{organization}/projects/{project}/billing/invoices— Issue an immutable itemized usage statementGET /api/v1/organizations/{organization}/projects/{project}/billing/invoices/{invoice}— Read invoice lines grouped by model and pinned rate revisionPOST /api/v1/organizations/{organization}/projects/{project}/billing/invoices/{invoice}/payment— Record one confirmed full external invoice paymentGET /api/v1/organizations/{organization}/projects/{project}/billing/media-retail-price-enrollment— Read workspace media selling-price enrollmentPOST /api/v1/organizations/{organization}/projects/{project}/billing/media-retail-price-enrollment— Set workspace media selling-price enrollmentGET /api/v1/organizations/{organization}/projects/{project}/billing/retail-price-enrollment— Read own workspace retail pricing modePOST /api/v1/organizations/{organization}/projects/{project}/billing/retail-price-enrollment— Enroll a workspace model in a platform selling pricePOST /api/v1/organizations/{organization}/projects/{project}/billing/tariffs— Publish an immutable customer selling rate revisionGET /api/v1/organizations/{organization}/projects/{project}/billing/tariffs/{model}/history— Read immutable customer text price historyGET /api/v1/organizations/{organization}/projects/{project}/budget— Read the platform upstream cost budget (installation only)POST /api/v1/organizations/{organization}/projects/{project}/budget— Create a platform upstream cost budget (installation only)GET /api/v1/organizations/{organization}/projects/{project}/chats— List personal saved Chat history or one continuation pageDELETE /api/v1/organizations/{organization}/projects/{project}/chats/{id}— Delete an owned Chat session in a workspaceGET /api/v1/organizations/{organization}/projects/{project}/chats/{id}— Read one complete owned saved Chat conversationPUT /api/v1/organizations/{organization}/projects/{project}/chats/{id}— Save an owned Chat session in a workspacePUT /api/v1/organizations/{organization}/projects/{project}/chats/{id}/archive— Archive or restore the authenticated owner’s Chat sessionGET /api/v1/organizations/{organization}/projects/{project}/chats/{id}/export— Export one owned saved conversationGET /api/v1/organizations/{organization}/projects/{project}/chats/draft— Read the persistent personal Chat draftPUT /api/v1/organizations/{organization}/projects/{project}/chats/draft— Save or clear the personal Chat draft with an expected revisionGET /api/v1/organizations/{organization}/projects/{project}/costs— Read platform upstream cost entries (installation only)GET /api/v1/organizations/{organization}/projects/{project}/generations— List private generations sessionsGET /api/v1/organizations/{organization}/projects/{project}/generations/{session}— Read a private saved generations timelinePATCH /api/v1/organizations/{organization}/projects/{project}/generations/{session}— Rename or archive a private video sessionPUT /api/v1/organizations/{organization}/projects/{project}/generations/{session}— Create a private video generations sessionDELETE /api/v1/organizations/{organization}/projects/{project}/generations/{session}/turns/{turn}— Delete retained instruction contentPUT /api/v1/organizations/{organization}/projects/{project}/generations/{session}/turns/{turn}— Append one retained video instructionPUT /api/v1/organizations/{organization}/projects/{project}/generations/{session}/turns/{turn}/intent— Bind a saved Video intent to a private turnPUT /api/v1/organizations/{organization}/projects/{project}/generations/{session}/turns/{turn}/task— Attach an existing authorized video taskGET /api/v1/organizations/{organization}/projects/{project}/generations/artifacts— List actual saved output referencesGET /api/v1/organizations/{organization}/projects/{project}/generations/artifacts/{task}/{kind}— Read an output availability recordGET /api/v1/organizations/{organization}/projects/{project}/generations/artifacts/{task}/{kind}/capture— Read saved artifact capture statusPOST /api/v1/organizations/{organization}/projects/{project}/generations/artifacts/{task}/{kind}/capture— Explicitly save a generated output into workspace materialsGET /api/v1/organizations/{organization}/projects/{project}/generations/artifacts/{task}/{kind}/content— Download an authorized retained outputGET /api/v1/organizations/{organization}/projects/{project}/generations/tasks— List saved Video tasks across workspace keysGET /api/v1/organizations/{organization}/projects/{project}/generations/tasks/{task}— Read a saved Video taskGET /api/v1/organizations/{organization}/projects/{project}/generations/tasks/{task}/diagnostics— Read saved customer billing and transport diagnosticsPOST /api/v1/organizations/{organization}/projects/{project}/generations/tasks/{task}/refresh— Explicitly refresh the original Video taskPOST /api/v1/organizations/{organization}/projects/{project}/generations/tasks/{task}/results/{kind}/refresh— Retrieve fresh output from the original Video taskGET /api/v1/organizations/{organization}/projects/{project}/guardrails— Read active workspace access policyPUT /api/v1/organizations/{organization}/projects/{project}/guardrails— Activate a validated workspace access-policy revisionGET /api/v1/organizations/{organization}/projects/{project}/guardrails/denials— Read latest 100 workspace preparation refusalsGET /api/v1/organizations/{organization}/projects/{project}/guardrails/detector-decisions— Read latest 100 workspace input detector decisionsGET /api/v1/organizations/{organization}/projects/{project}/guardrails/detectors— List authorized workspace text detector declarationsGET /api/v1/organizations/{organization}/projects/{project}/guardrails/dispatch-denials— Read latest 100 workspace dispatch policy exceptionsGET /api/v1/organizations/{organization}/projects/{project}/guardrails/history— Browse immutable workspace policy revision metadataGET /api/v1/organizations/{organization}/projects/{project}/guardrails/image-detectors— List authorized workspace image detector declarationsPOST /api/v1/organizations/{organization}/projects/{project}/guardrails/image-detectors/{detector}/preview— Preview explicitly consented workspace image processingPOST /api/v1/organizations/{organization}/projects/{project}/guardrails/input-preview— Test synthetic input against local text rules without enforcementGET /api/v1/organizations/{organization}/projects/{project}/guardrails/media-detectors— List workspace-authorized media inspection configurationsPOST /api/v1/organizations/{organization}/projects/{project}/guardrails/output-preview— Test synthetic output against local text rules without enforcementPOST /api/v1/organizations/{organization}/projects/{project}/guardrails/preview— Preview draft model and Provider access without persistenceGET /api/v1/organizations/{organization}/projects/{project}/guardrails/revisions/{revision}— Inspect a preserved workspace policy version before restoringPOST /api/v1/organizations/{organization}/projects/{project}/guardrails/rollback— Restore a preserved policy as a new active revisionGET /api/v1/organizations/{organization}/projects/{project}/keys— List saved workspace API-key metadataPOST /api/v1/organizations/{organization}/projects/{project}/keys— Issue a workspace API key and return its secret onceDELETE /api/v1/organizations/{organization}/projects/{project}/keys/{key}— Revoke a workspace API keyPATCH /api/v1/organizations/{organization}/projects/{project}/keys/{key}— Update workspace API key name and model grantsGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/capacity— Inspect requests contributing unresolved key capacityGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/concurrency-limit— Read API key concurrency policyPUT /api/v1/organizations/{organization}/projects/{project}/keys/{key}/concurrency-limit— Set API key concurrency policyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/concurrency-limit/history— List API key concurrency policy historyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/guardrail— Read a workspace-scoped key policy assignmentPUT /api/v1/organizations/{organization}/projects/{project}/keys/{key}/guardrail— Assign a preserved workspace policy revision to an active keyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/guardrail/history— Read immutable key policy assignment historyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/ip-policy— Read API key source policyPUT /api/v1/organizations/{organization}/projects/{project}/keys/{key}/ip-policy— Set API key source policyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/ip-policy/history— List API key source policy historyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/request-rate-limit— Read API key request rate policyPUT /api/v1/organizations/{organization}/projects/{project}/keys/{key}/request-rate-limit— Set API key request rate policyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/request-rate-limit/history— List API key request rate policy historyPOST /api/v1/organizations/{organization}/projects/{project}/keys/{key}/rotate— Atomically replace a key while preserving its grants and expiryGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/spending-limit— List API key spending limitsPUT /api/v1/organizations/{organization}/projects/{project}/keys/{key}/spending-limit/{currency}— Set API key spending limitGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/spending-limit/{currency}/history— List API key spending historyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/token-rate-limit— Read API key token rate policyPUT /api/v1/organizations/{organization}/projects/{project}/keys/{key}/token-rate-limit— Set API key token rate policyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/token-rate-limit/history— List API key token rate policy historyGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/token-usage-window— Read API key token usage windowGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/units/limit— Read an API key’s Credits spending limit and commitmentPUT /api/v1/organizations/{organization}/projects/{project}/keys/{key}/units/limit— Set an API key’s Credits spending limitGET /api/v1/organizations/{organization}/projects/{project}/keys/{key}/units/limit/history— List API key Credits spending limit historyGET /api/v1/organizations/{organization}/projects/{project}/media/asset-operation-models— Discover saved native-operation model contextsGET /api/v1/organizations/{organization}/projects/{project}/media/operations— List historical native material operationsGET /api/v1/organizations/{organization}/projects/{project}/media/operations/{id}— Read historical native material operationsPOST /api/v1/organizations/{organization}/projects/{project}/media/operations/{id}/cancel— Abandon an unclaimed native operation after key expiryGET /api/v1/organizations/{organization}/projects/{project}/media/operations/by-idempotency/{id}— Read historical native material operationsGET /api/v1/organizations/{organization}/projects/{project}/requests— Read automatically retained gateway request activityGET /api/v1/organizations/{organization}/projects/{project}/requests/{attempt}— Read a recorded gateway requestGET /api/v1/organizations/{organization}/projects/{project}/requests/{attempt}/guardrails— Read immutable policy attribution for an allowed dispatchDELETE /api/v1/organizations/{organization}/projects/{project}/requests/{attempt}/payloads— Delete retained content without deleting accounting recordsGET /api/v1/organizations/{organization}/projects/{project}/requests/{attempt}/payloads— Read retained request content in an authorized workspaceGET /api/v1/organizations/{organization}/projects/{project}/requests/{attempt}/usage-reconciliation— Read recorded supplemental request usagePOST /api/v1/organizations/{organization}/projects/{project}/requests/{attempt}/usage-reconciliation— Supplement missing native request usage from captured OpenRouter evidenceGET /api/v1/organizations/{organization}/projects/{project}/requests/export— Export filtered customer-safe request metadata as CSVGET /api/v1/organizations/{organization}/projects/{project}/spending-limit— List workspace spending currenciesGET /api/v1/organizations/{organization}/projects/{project}/spending-limit/{currency}— Read a workspace spending limitPUT /api/v1/organizations/{organization}/projects/{project}/spending-limit/{currency}— Set a workspace spending limitGET /api/v1/organizations/{organization}/projects/{project}/spending-limit/{currency}/history— List workspace spending revisionsGET /api/v1/organizations/{organization}/projects/{project}/units/limit— Read the workspace Credits spending limit and commitmentPUT /api/v1/organizations/{organization}/projects/{project}/units/limit— Set the workspace Credits spending limitGET /api/v1/organizations/{organization}/projects/{project}/units/limit/history— List workspace Credits spending limit historyGET /api/v1/organizations/{organization}/projects/{project}/video/draft— Read a mutable personal Video composerPUT /api/v1/organizations/{organization}/projects/{project}/video/draft— Save or clear a mutable personal Video composerGET /api/v1/organizations/{organization}/projects/{project}/video/intents— List the current actor video intent indexDELETE /api/v1/organizations/{organization}/projects/{project}/video/intents/{intent}— Erase saved intent content without cancelling its jobGET /api/v1/organizations/{organization}/projects/{project}/video/intents/{intent}— Restore a saved video intent and its historical jobPUT /api/v1/organizations/{organization}/projects/{project}/video/intents/{intent}— Save an immutable video submission intent with typed Niu referencesPOST /api/v1/organizations/{organization}/projects/{project}/video/intents/{intent}/submit— Explicitly submit or replay an immutable saved video intentGET /api/v1/pricing/customers— List named companies for customer-specific promotionsGET /api/v1/pricing/models— List models eligible for customer tariff publicationGET /api/v1/pricing/organizations/{organization}/workspaces/{project}/tariffs— Page current customer selling tariffsGET /api/v1/pricing/organizations/{organization}/workspaces/{project}/tariffs/{model}/history— Read platform customer selling-price historyGET /api/v1/pricing/standard-prices— List current platform standard pricesPOST /api/v1/pricing/standard-prices— Publish a platform standard selling-price revisionGET /api/v1/pricing/standard-prices/{price}/history— Read immutable standard and promotion historyGET /api/v1/pricing/standard-prices/{price}/preview— Preview a customer applicable priceGET /api/v1/pricing/standard-prices/{price}/promotions— Read promotion periods with complete retirement coveragePOST /api/v1/pricing/standard-prices/{price}/promotions— Publish one finite global or customer pricePOST /api/v1/pricing/standard-prices/{price}/promotions/{promotion}/retire— Append a promotion eligibility cutoffGET /api/v1/pricing/standard-prices/models— List registered shared models for standard-price preparationGET /api/v1/pricing/targets— Discover named platform pricing targetsPOST /api/v1/setup/default-workspace— Get or create the installation default workspaceGET /api/v1/workspaces— List an authorized page of workspacesPOST /api/v1/workspaces— Create a workspace with retry-safe identityDELETE /api/v1/workspaces/{workspace}— Delete an empty workspace by identityPATCH /api/v1/workspaces/{workspace}— Rename a workspace by identityGET /api/v1/workspaces/{workspace}/artifacts— List actual saved output referencesGET /api/v1/workspaces/{workspace}/artifacts/{task}/{kind}— Read an output availability recordGET /api/v1/workspaces/{workspace}/artifacts/{task}/{kind}/capture— Read saved artifact capture statusPOST /api/v1/workspaces/{workspace}/artifacts/{task}/{kind}/capture— Explicitly save a generated output into workspace materialsGET /api/v1/workspaces/{workspace}/artifacts/{task}/{kind}/content— Download an authorized retained outputGET /api/v1/workspaces/{workspace}/assets— List saved workspace materialsPOST /api/v1/workspaces/{workspace}/assets— Save a workspace materialDELETE /api/v1/workspaces/{workspace}/assets/{asset}— Delete a saved workspace materialGET /api/v1/workspaces/{workspace}/assets/{asset}— Read workspace material metadataPATCH /api/v1/workspaces/{workspace}/assets/{asset}— Rename a saved workspace materialGET /api/v1/workspaces/{workspace}/assets/{asset}/content— Download saved workspace material bytesGET /api/v1/workspaces/{workspace}/billing— Read workspace customer charges, tariffs and latest 100 invoicesGET /api/v1/workspaces/{workspace}/chats— List personal saved Chat history or one continuation pageDELETE /api/v1/workspaces/{workspace}/chats/{id}— Delete an owned Chat session in a workspaceGET /api/v1/workspaces/{workspace}/chats/{id}— Read one complete owned saved Chat conversationPUT /api/v1/workspaces/{workspace}/chats/{id}— Save an owned Chat session in a workspacePUT /api/v1/workspaces/{workspace}/chats/{id}/archive— Archive or restore the authenticated owner’s Chat sessionGET /api/v1/workspaces/{workspace}/chats/{id}/export— Export one owned saved conversationGET /api/v1/workspaces/{workspace}/chats/draft— Read the persistent personal Chat draftPUT /api/v1/workspaces/{workspace}/chats/draft— Save or clear the personal Chat draft with an expected revisionGET /api/v1/workspaces/{workspace}/keys— List workspace API keys with aggregated limits and policiesPOST /api/v1/workspaces/{workspace}/keys— Create a workspace API key with optional initial limits and policiesDELETE /api/v1/workspaces/{workspace}/keys/{key}— Revoke a workspace API keyGET /api/v1/workspaces/{workspace}/keys/{key}— Retrieve a workspace API key with its policies and usage windowPATCH /api/v1/workspaces/{workspace}/keys/{key}— Update workspace API key metadata and policiesGET /api/v1/workspaces/{workspace}/keys/{key}/capacity— Inspect requests contributing unresolved key capacityGET /api/v1/workspaces/{workspace}/keys/{key}/concurrency-limit— Read API key concurrency policyPUT /api/v1/workspaces/{workspace}/keys/{key}/concurrency-limit— Set API key concurrency policyGET /api/v1/workspaces/{workspace}/keys/{key}/concurrency-limit/history— List API key concurrency policy historyGET /api/v1/workspaces/{workspace}/keys/{key}/ip-policy— Read API key source policyPUT /api/v1/workspaces/{workspace}/keys/{key}/ip-policy— Set API key source policyGET /api/v1/workspaces/{workspace}/keys/{key}/ip-policy/history— List API key source policy historyGET /api/v1/workspaces/{workspace}/keys/{key}/request-rate-limit— Read API key request rate policyPUT /api/v1/workspaces/{workspace}/keys/{key}/request-rate-limit— Set API key request rate policyGET /api/v1/workspaces/{workspace}/keys/{key}/request-rate-limit/history— List API key request rate policy historyPOST /api/v1/workspaces/{workspace}/keys/{key}/rotate— Rotate a workspace API key while preserving its policies and expiryGET /api/v1/workspaces/{workspace}/keys/{key}/spending-limit— List API key spending limitsPUT /api/v1/workspaces/{workspace}/keys/{key}/spending-limit/{currency}— Set API key spending limitGET /api/v1/workspaces/{workspace}/keys/{key}/spending-limit/{currency}/history— List API key spending historyGET /api/v1/workspaces/{workspace}/keys/{key}/token-rate-limit— Read API key token rate policyPUT /api/v1/workspaces/{workspace}/keys/{key}/token-rate-limit— Set API key token rate policyGET /api/v1/workspaces/{workspace}/keys/{key}/token-rate-limit/history— List API key token rate policy historyGET /api/v1/workspaces/{workspace}/keys/{key}/token-usage-window— Read API key token usage windowGET /api/v1/workspaces/{workspace}/keys/{key}/units/limit— Read an API key’s Credits spending limit and commitmentPUT /api/v1/workspaces/{workspace}/keys/{key}/units/limit— Set an API key’s Credits spending limitGET /api/v1/workspaces/{workspace}/keys/{key}/units/limit/history— List API key Credits spending limit historyGET /api/v1/workspaces/{workspace}/keys/requests/{request}— Reconcile an API key creation or rotation requestGET /api/v1/workspaces/{workspace}/requests— Read automatically retained gateway request activityGET /api/v1/workspaces/{workspace}/requests/{attempt}— Read a recorded gateway requestGET /api/v1/workspaces/{workspace}/requests/{attempt}/usage-reconciliation— Read recorded supplemental request usagePOST /api/v1/workspaces/{workspace}/requests/{attempt}/usage-reconciliation— Supplement missing native request usage from captured OpenRouter evidenceGET /api/v1/workspaces/{workspace}/sessions— List private generations sessionsGET /api/v1/workspaces/{workspace}/sessions/{session}— Read a private saved generations timelinePATCH /api/v1/workspaces/{workspace}/sessions/{session}— Rename or archive a private video sessionPUT /api/v1/workspaces/{workspace}/sessions/{session}— Create a private video generations sessionDELETE /api/v1/workspaces/{workspace}/sessions/{session}/turns/{turn}— Delete retained instruction contentPUT /api/v1/workspaces/{workspace}/sessions/{session}/turns/{turn}— Append one retained video instructionPUT /api/v1/workspaces/{workspace}/sessions/{session}/turns/{turn}/intent— Bind a saved Video intent to a private turnPUT /api/v1/workspaces/{workspace}/sessions/{session}/turns/{turn}/task— Attach an existing authorized video taskGET /api/v1/workspaces/{workspace}/spending-limit— List workspace spending currenciesGET /api/v1/workspaces/{workspace}/spending-limit/{currency}— Read a workspace spending limitPUT /api/v1/workspaces/{workspace}/spending-limit/{currency}— Set a workspace spending limitGET /api/v1/workspaces/{workspace}/spending-limit/{currency}/history— List workspace spending revisionsGET /api/v1/workspaces/{workspace}/tasks— List saved Video tasks across workspace keysGET /api/v1/workspaces/{workspace}/tasks/{task}— Read a saved Video taskGET /api/v1/workspaces/{workspace}/tasks/{task}/diagnostics— Read saved customer billing and transport diagnosticsPOST /api/v1/workspaces/{workspace}/tasks/{task}/refresh— Explicitly refresh the original Video taskPOST /api/v1/workspaces/{workspace}/tasks/{task}/results/{kind}/refresh— Retrieve fresh output from the original Video taskGET /api/v1/workspaces/{workspace}/units/limit— Read the workspace Credits spending limit and commitmentPUT /api/v1/workspaces/{workspace}/units/limit— Set the workspace Credits spending limitGET /api/v1/workspaces/{workspace}/units/limit/history— List workspace Credits spending limit historyGET /api/v1/workspaces/{workspace}/video/draft— Read a mutable personal Video composerPUT /api/v1/workspaces/{workspace}/video/draft— Save or clear a mutable personal Video composerGET /api/v1/workspaces/{workspace}/video/intents— List the current actor video intent indexDELETE /api/v1/workspaces/{workspace}/video/intents/{intent}— Erase saved intent content without cancelling its jobGET /api/v1/workspaces/{workspace}/video/intents/{intent}— Restore a saved video intent and its historical jobPUT /api/v1/workspaces/{workspace}/video/intents/{intent}— Save an immutable video submission intent with typed Niu referencesPOST /api/v1/workspaces/{workspace}/video/intents/{intent}/submit— Explicitly submit or replay an immutable saved video intentGET /api/v1/workspaces/by-route/{route_slug}— Resolve an authorized canonical workspace route
Service endpoints
Section titled “Service endpoints”GET /api/v1/payments/readiness— Read payment or scoped funding readinessGET /api/v1/platform/audit-events— List platform operation audit logsGET /api/v1/platform/branding— Read platform branding and theme configurationPUT /api/v1/platform/branding— Save platform branding and theme configurationGET /api/v1/platform/configuration— Read platform payment configuration presencePUT /api/v1/platform/currency— Configure the installation currency onceGET /api/v1/platform/customer-accounts— Discover named customer accounts for platform financial administrationGET /api/v1/platform/financial-recovery— Read committed financial recovery progressGET /api/v1/platform/payments/epay— Read EPay configuration with platform administrator read accessPUT /api/v1/platform/payments/epay— Save encrypted EPay configuration with platform administrator write accessGET /api/v1/platform/payments/integrations— List supported payment integrationsGET /api/v1/platform/payments/stripe/verification— Read Stripe verification evidencePOST /api/v1/platform/payments/stripe/verification— Check the configured Stripe accountGET /api/v1/platform/units— Read branded-unit configurationPOST /api/v1/platform/units/definitions— Publish an immutable consumption-unit definitionGET /api/v1/platform/units/media/tariffs— List latest explicit Credits media tariffsPOST /api/v1/platform/units/media/tariffs— Publish a versioned Credits media consumption tariffGET /api/v1/platform/units/mode— Preview installation billing-mode incompatibilitiesPUT /api/v1/platform/units/mode— Publish a preview-confirmed installation billing modePOST /api/v1/platform/units/mode/previews— Save a billing-mode change previewGET /api/v1/platform/units/mode/previews/{preview}— Read an original saved billing-mode previewPOST /api/v1/platform/units/rules— Publish an immutable Credits purchase ruleGET /api/v1/platform/units/tariffs— Read the latest explicit Credits text tariff for a modelPOST /api/v1/platform/units/tariffs— Publish a versioned Credits text consumption tariffGET /catalog/v1/models— List model aliases explicitly published by the gateway operatorGET /enterprise/readyz— Check Enterprise module readinessGET /healthz— Check process healthGET /payments/epay/notify— Receive a signed classic EPay query notificationPOST /payments/epay/notify— Receive a signed classic EPay form notificationPOST /payments/stripe/notify— Receive a signed Stripe checkout notificationPOST /payments/zhifux/notify— Receive signed merchant notificationGET /readyz— Check gateway readiness