> ## Documentation Index > Fetch the complete documentation index at: https://synthlabs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Launch a task matrix > Launch a bounded matrix of supported agent and model configurations against one exact immutable task version. ## OpenAPI ````yaml /api-reference/openapi.json post /api/v1/users/{user_id}/registry/packages/task/versions/{version_id}/executions openapi: 3.1.0 info: title: Synth API Reference version: 2026-08-23.alpha description: HTTP API for your account, tasks, datasets, agent runs and usage. servers: - url: https://sprites-gateway.api.synthlabs.ai description: Synth API security: [] tags: - name: Identity description: Manage customer tokens without exposing internal service credentials. - name: Registry description: >- Create, discover, set visibility, version, execute, and inspect results for Harbor-compatible tasks and datasets. - name: Managed execution description: Validate, run, observe, and retrieve Harbor-compatible managed work. - name: Usage description: Inspect authoritative current rolling quota. paths: /api/v1/users/{user_id}/registry/packages/task/versions/{version_id}/executions: post: tags: - Registry summary: Launch a task matrix description: >- Launch a bounded matrix of supported agent and model configurations against one exact immutable task version. operationId: launchRegistryTaskMatrix parameters: - in: path name: user_id required: true schema: format: uuid title: User Id type: string - in: path name: version_id required: true schema: format: uuid title: Version Id type: string - in: header name: Idempotency-Key required: true schema: maxLength: 100 minLength: 1 title: Idempotency-Key type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/RegistryMatrixLaunchRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/RegistryMatrixLaunchResponse' description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - UserBearer: [] components: schemas: RegistryMatrixLaunchRequest: additionalProperties: false description: Bounded matrix over one exact immutable task version. properties: attempts: default: 1 maximum: 10 minimum: 1 title: Attempts type: integer concurrency_per_configuration: default: 1 maximum: 10 minimum: 1 title: Concurrency Per Configuration type: integer configurations: items: $ref: '#/components/schemas/RegistryMatrixConfiguration' maxItems: 8 minItems: 1 title: Configurations type: array required: - configurations title: RegistryMatrixLaunchRequest type: object RegistryMatrixLaunchResponse: additionalProperties: false description: Scored executions created for one exact task version matrix. properties: contract_version: const: synth.registry.v1 default: synth.registry.v1 enum: - synth.registry.v1 title: Contract Version type: string launches: items: $ref: '#/components/schemas/RegistryMatrixLaunch' maxItems: 8 minItems: 1 title: Launches type: array task_ref: maxLength: 640 minLength: 3 title: Task Ref type: string task_version_id: format: uuid title: Task Version Id type: string required: - task_version_id - task_ref - launches title: RegistryMatrixLaunchResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object RegistryMatrixConfiguration: additionalProperties: false description: >- One supported agent/model configuration applied to the same task version. properties: agent: enum: - claude-code - codex title: Agent type: string model: const: Qwen/Qwen3-8B default: Qwen/Qwen3-8B enum: - Qwen/Qwen3-8B title: Model type: string required: - agent title: RegistryMatrixConfiguration type: object RegistryMatrixLaunch: additionalProperties: false description: One pinned configuration and its authoritative scored execution. properties: configuration: $ref: '#/components/schemas/RegistryMatrixConfiguration' execution: $ref: '#/components/schemas/RegistryExecution' required: - configuration - execution title: RegistryMatrixLaunch type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object RegistryExecution: additionalProperties: false description: Current customer-safe observation of one package-bound cloud execution. properties: artifacts_url: anyOf: - maxLength: 1000 type: string - type: 'null' title: Artifacts Url configuration: anyOf: - $ref: '#/components/schemas/RegistryExecutionConfiguration' - type: 'null' created_at: format: date-time title: Created At type: string events_url: anyOf: - maxLength: 1000 type: string - type: 'null' title: Events Url failure: anyOf: - maxLength: 2000 type: string - type: 'null' title: Failure id: format: uuid title: Id type: string kind: enum: - managed_rl - eval - harbor title: Kind type: string role: maxLength: 120 minLength: 1 title: Role type: string score: anyOf: - type: number - type: 'null' title: Score state: maxLength: 64 minLength: 1 title: State type: string status_url: maxLength: 1000 minLength: 1 title: Status Url type: string trials: items: $ref: '#/components/schemas/RegistryExecutionTrial' maxItems: 100 title: Trials type: array updated_at: format: date-time title: Updated At type: string required: - id - kind - state - role - status_url - created_at - updated_at title: RegistryExecution type: object RegistryExecutionConfiguration: additionalProperties: false description: Safe identity for one customer-selected execution configuration. properties: agent: anyOf: - maxLength: 255 type: string - type: 'null' title: Agent cli_tool: anyOf: - enum: - claude - codex type: string - type: 'null' title: Cli Tool harness: anyOf: - maxLength: 640 type: string - type: 'null' title: Harness model: anyOf: - maxLength: 1024 type: string - type: 'null' title: Model name: anyOf: - maxLength: 255 type: string - type: 'null' title: Name title: RegistryExecutionConfiguration type: object RegistryExecutionTrial: additionalProperties: false description: >- One execution sample projected without runtime or infrastructure configuration. properties: attempt_number: maximum: 100 minimum: 1 title: Attempt Number type: integer failure: anyOf: - maxLength: 2000 type: string - type: 'null' title: Failure id: format: uuid title: Id type: string ordinal: maximum: 100 minimum: 1 title: Ordinal type: integer score: anyOf: - type: number - type: 'null' title: Score state: maxLength: 64 minLength: 1 title: State type: string required: - id - ordinal - attempt_number - state title: RegistryExecutionTrial type: object securitySchemes: UserBearer: description: Synth customer access token for the current user and organization. scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.