Create Job

Create a new job to fold protein sequences using AI models. The job will be processed asynchronously and you can track its status using the returned job ID.

Authorization

bearerAuth

AuthorizationBearer <token>

Bearer token authentication. Use your API key with the format: Authorization: Bearer sk-...your-api-key

In: header

Query Parameters

from?string

Optional library item ID to associate with this job

Formatuuid

Request Body

application/json

Job creation request with sequences and parameters

name*string

Name of the job

isPublic?boolean

Whether the job results should be publicly accessible

Defaultfalse

sequences*

List of sequences to fold

Items1 <= items

params*

constraints?

Optional constraints to apply during folding

chatId?string

Optional chat ID to associate with this job

Formatuuid

Response Body

`application/json`

curl -X POST "https://api.fastfold.ai/v1/jobs" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Boltz-2 Affinity Job",
    "isPublic": false,
    "sequences": [
      {
        "proteinChain": {
          "sequence": "MTEYKLVVVGACGVGKSALTIQLIQNHFVDEYDPTIEDSYRKQVVIDGETCLLDILDTAGQEEYSAMRDQYMRTGEGFLCVFAINNTKSFEDIHHYREQIKRVKDSEDVPMVLVGNKCDLPSRTVDTKQAQDLARSYGIPFIETSAKTRQGVDDAFYTLVREIRKHKE"
        }
      },
      {
        "ligandSequence": {
          "sequence": "U4U",
          "is_ccd": true,
          "property_type": "affinity"
        }
      }
    ],
    "params": {
      "modelName": "boltz-2"
    }
  }'

curl -X POST "https://api.fastfold.ai/v1/jobs" \  -H "Content-Type: application/json" \  -d '{    "name": "My Boltz-2 Affinity Job",    "isPublic": false,    "sequences": [      {        "proteinChain": {          "sequence": "MTEYKLVVVGACGVGKSALTIQLIQNHFVDEYDPTIEDSYRKQVVIDGETCLLDILDTAGQEEYSAMRDQYMRTGEGFLCVFAINNTKSFEDIHHYREQIKRVKDSEDVPMVLVGNKCDLPSRTVDTKQAQDLARSYGIPFIETSAKTRQGVDDAFYTLVREIRKHKE"        }      },      {        "ligandSequence": {          "sequence": "U4U",          "is_ccd": true,          "property_type": "affinity"        }      }    ],    "params": {      "modelName": "boltz-2"    }  }'

{
  "jobId": "550e8400-e29b-41d4-a716-446655440000",
  "jobRunId": "660e8400-e29b-41d4-a716-446655440001",
  "jobName": "My Protein Fold",
  "jobStatus": "INITIALIZED",
  "sequencesIds": [
    "770e8400-e29b-41d4-a716-446655440002"
  ]
}

{
  "message": "Invalid sequence format"
}

{
  "message": "Unauthorized"
}

{
  "message": "Daily quota exceeded. Limit: 30 calls per day. Current: 30 calls."
}

Create Job

Authorization

Query Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`