Skip to content
GatewayOpenAPI

List tasks

GET/api/gateway/v1/tasks

Reads and cancellation use the original frozen task identity, not current model configuration. The key must retain modelInvoke and permission for the original project and route. Task recovery remains available during financial recovery subject to current identity and product authorization. Unknown or expired tasks may have been submitted: inspect and reconcile the existing task before creating another invocation. HTTP disconnect does not cancel a task.

Organization API key authentication

Authorization: Bearer $SINECLOUD_API_KEY

Required scopes: modelInvoke

Parameters

limit · query · Optional
cursor · query · Optional
Opaque nextCursor from the preceding page; takes precedence over before.
before · query · Optional
Alternative pagination cursor when cursor is absent.
routeId · query · Optional
Filter by an authorized original route.
x-sine-project-id · header · Optional
Select an organization project. A project-restricted key defaults to its bound project and cannot select another project. The projectId query parameter takes precedence.
projectId · query · Optional
Optional project selection; takes precedence over x-sine-project-id and must respect the key restriction.

Responses

200
Visible tasks with an opaque nextCursor.
400
Invalid request, project identifier, unsupported model parameters or operation configuration.
401
Missing, expired, revoked or invalid organization Bearer API key.
403
The key scope, project restriction, route policy, current membership or product entitlement denies access.
404
The project, route or authorized task was not found.
429
Rate or concurrency limit reached. Honor Retry-After when returned.
500
Sanitized Cloud or Gateway failure.
503
Gateway or durable task execution is unavailable. Restore the required service before continuing.

Loading API reference…

Gateway · Setup & authentication

Base URLhttps://sinecloud.dev/api/gateway/v1

Before your first request

Select your organization, prepare resources in Console, and issue an organization API key with the required product scopes. Current permissions, resource access, budget and available funds are checked on every call.

Choose an available route from the model catalog and use its ID as model. The catalog covers model discovery, chat completions, responses, messages, embeddings, images, audio, generation and durable task lifecycle. Use the appropriate native protocol and preserve JSON, streaming SSE, multipart and binary body formats. Review current model access, supported operations and billing in Console.

Grant modelRead to list routes and modelInvoke for inference and task operations. Project restrictions and route policies apply on every request. Managed routes require available funds and budget; own-key routes use the organization’s provider credentials. Keep original task IDs and inspect durable status before retrying uncertain execution.

Organization key authentication and base URL

The production API origin is https://sinecloud.dev; the documentation origin does not serve product requests. The path prefix is /api/gateway/v1. Use the complete path documented for the operation, replacing resource IDs, models and endpoint revisions with your actual selections.

Authorization: Bearer $SINECLOUD_API_KEY

Set SINECLOUD_API_KEY to your own environment variable value; never use platform service credentials. Each operation lists required scopes in x-sinecloud-scopes.

This reference is read-only. Run requests in Console or your own client. Browsing documentation never creates a key, starts execution or incurs an execution charge. Keep request IDs and execution receipts; a lost connection does not cancel work. Follow the operation’s recovery instructions before submitting again.

Console

Type to search…

↑↓ navigate↵ selectEsc Close