Launch a task matrix

Launch a bounded matrix of supported agent and model configurations against one exact immutable task version.

POST /api/v1/users/{user_id}/registry/packages/task/versions/{version_id}/executions

Launch a task matrix

cURL

curl --request POST \
  --url https://sprites-gateway.api.synthlabs.ai/api/v1/users/{user_id}/registry/packages/task/versions/{version_id}/executions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "configurations": [
    {
      "model": "Qwen/Qwen3-8B"
    }
  ]
}
'

201

{
  "launches": [
    {
      "configuration": {
        "agent": "claude-code",
        "model": "Qwen/Qwen3-8B"
      },
      "execution": {
        "created_at": "2023-11-07T05:31:56Z",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "kind": "managed_rl",
        "role": "<string>",
        "state": "<string>",
        "status_url": "<string>",
        "updated_at": "2023-11-07T05:31:56Z",
        "artifacts_url": "<string>",
        "configuration": {
          "agent": "<string>",
          "cli_tool": "claude",
          "harness": "<string>",
          "model": "<string>",
          "name": "<string>"
        },
        "events_url": "<string>",
        "failure": "<string>",
        "score": 123,
        "trials": [
          {
            "attempt_number": 50,
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "ordinal": 50,
            "state": "<string>",
            "failure": "<string>",
            "score": 123
          }
        ]
      }
    }
  ],
  "task_ref": "<string>",
  "task_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "contract_version": "synth.registry.v1"
}

Authorizations

Authorization · string · header · required

Synth customer access token for the current user and organization.

Headers

Idempotency-Key · string · required

Required string length: 1 - 100

Path Parameters

user_id · string<uuid> · required

version_id · string<uuid> · required

Body

application/json

Bounded matrix over one exact immutable task version.

configurations · RegistryMatrixConfiguration · object[] · required

Required array length: 1 - 8 elements

Show child attributes

attempts · integer · default: 1

Required range: 1 <= x <= 10

concurrency_per_configuration · integer · default: 1

Required range: 1 <= x <= 10

Response

201

application/json

Successful Response

Scored executions created for one exact task version matrix.

launches · RegistryMatrixLaunch · object[] · required

Required array length: 1 - 8 elements

Show child attributes

task_ref · string · required

Required string length: 3 - 640

task_version_id · string<uuid> · required

contract_version · enum<string> · default: synth.registry.v1

Available options: synth.registry.v1

Allowed value: "synth.registry.v1"