curl --request POST \
  --url https://api.firedrill.run/v1/ci/suites/{ciSuiteId}/claims \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "runnerId": "<string>",
  "revision": "<string>"
}
'

import requests

url = "https://api.firedrill.run/v1/ci/suites/{ciSuiteId}/claims"

payload = {
    "runnerId": "<string>",
    "revision": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({runnerId: '<string>', revision: '<string>'})
};

fetch('https://api.firedrill.run/v1/ci/suites/{ciSuiteId}/claims', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firedrill.run/v1/ci/suites/{ciSuiteId}/claims",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'runnerId' => '<string>',
    'revision' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firedrill.run/v1/ci/suites/{ciSuiteId}/claims"

	payload := strings.NewReader("{\n  \"runnerId\": \"<string>\",\n  \"revision\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firedrill.run/v1/ci/suites/{ciSuiteId}/claims")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"runnerId\": \"<string>\",\n  \"revision\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firedrill.run/v1/ci/suites/{ciSuiteId}/claims")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"runnerId\": \"<string>\",\n  \"revision\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "claimed",
  "suite": {
    "schemaVersion": 1,
    "ciSuiteId": "<string>",
    "organizationId": "<string>",
    "projectId": "<string>",
    "environmentId": "<string>",
    "provider": "github_actions",
    "suiteKey": "<string>",
    "source": {
      "kind": "single_revision",
      "candidateRevision": "<string>"
    },
    "evidenceUrl": "<string>",
    "state": "preparing",
    "builds": [
      {
        "schemaVersion": 1,
        "side": "baseline",
        "state": "queued",
        "updatedAtMs": 0,
        "sourceKind": "pinned_build",
        "revision": "<string>",
        "buildAttemptId": "<string>",
        "buildHash": "<string>",
        "failure": {
          "schemaVersion": 1,
          "code": "<string>",
          "source": "framework",
          "message": "<string>",
          "retryable": true,
          "issues": [],
          "correlationId": "<string>",
          "details": {},
          "evidence": {
            "runId": "<string>",
            "sequence": 4503599627370495
          }
        }
      }
    ],
    "counts": {
      "logicalCases": 0,
      "attemptCases": 0,
      "pending": 0,
      "active": 0,
      "passed": 0,
      "failed": 0,
      "inconclusive": 0,
      "error": 0,
      "cancelled": 0
    },
    "version": 0,
    "createdAtMs": 0,
    "updatedAtMs": 0,
    "runnerAdmissionRequired": true,
    "repositoryBindingId": "<string>",
    "credentialId": "<string>",
    "createdBy": "<string>",
    "ciInvocationId": "<string>",
    "cancellationReason": "<string>",
    "conclusion": "passed",
    "result": {
      "schemaVersion": 1,
      "ciSuiteId": "<string>",
      "conclusion": "passed",
      "durationMs": 0,
      "gate": {
        "blockingClassifications": [
          "contract"
        ],
        "candidate": {
          "logicalCases": 0,
          "passed": 0,
          "failed": 0,
          "inconclusive": 0,
          "error": 0,
          "cancelled": 0
        },
        "blocksMerge": true,
        "reason": "passed"
      },
      "summaries": [
        {
          "logicalCases": 0,
          "passed": 0,
          "failed": 0,
          "inconclusive": 0,
          "error": 0,
          "cancelled": 0,
          "side": "baseline",
          "classification": "contract",
          "attemptCases": 0,
          "observedSamples": 0,
          "passRate": 0.5,
          "confidence95": {
            "method": "wilson",
            "lower": 0.5,
            "upper": 0.5
          },
          "timing": {
            "measuredRuns": 4503599627370495,
            "meanMs": 1,
            "p50Ms": 1,
            "p95Ms": 1
          }
        }
      ],
      "comparisons": {
        "totalPairs": 0,
        "inspectedPairs": 0,
        "changedPairs": 0,
        "unchangedPairs": 0,
        "notComparablePairs": 0,
        "uninspectedPairs": 0,
        "inspectionErrors": 0,
        "details": [
          {
            "drillId": "<string>",
            "trial": 5000,
            "seed": "<string>",
            "baseline": {
              "hostedRunId": "<string>",
              "evidenceBundleId": "<string>",
              "revision": "<string>",
              "attempt": 5,
              "outcome": "passed",
              "durationMs": 0
            },
            "candidate": {
              "hostedRunId": "<string>",
              "evidenceBundleId": "<string>",
              "revision": "<string>",
              "attempt": 5,
              "outcome": "passed",
              "durationMs": 0
            },
            "compatibility": {
              "status": "exact_inputs",
              "canAttributeBehaviorChange": true,
              "differences": [
                "drill"
              ],
              "explanation": "<string>"
            },
            "outcome": "changed",
            "timing": {
              "baselineMs": 0,
              "candidateMs": 0,
              "deltaMs": 0
            },
            "changes": {
              "verdictChanged": true,
              "operationCounts": {
                "total": 0,
                "items": [
                  {
                    "subject": "<string>",
                    "baseline": 0,
                    "candidate": 0,
                    "delta": 0,
                    "baselineErrors": 0,
                    "candidateErrors": 0
                  }
                ],
                "omitted": 0
              },
              "stateChangeCounts": {
                "total": 0,
                "items": [
                  {
                    "subject": "<string>",
                    "baseline": 0,
                    "candidate": 0,
                    "delta": 0
                  }
                ],
                "omitted": 0
              },
              "eventCounts": {
                "total": 0,
                "items": [
                  {
                    "subject": "<string>",
                    "baseline": 0,
                    "candidate": 0,
                    "delta": 0
                  }
                ],
                "omitted": 0
              },
              "assertions": {
                "total": 0,
                "items": [
                  {
                    "checkpointId": "<string>",
                    "assertionId": "<string>",
                    "actualChanged": true,
                    "baseline": "passed",
                    "candidate": "passed",
                    "expectedChanged": true
                  }
                ],
                "omitted": 0
              },
              "interactions": {
                "total": 0,
                "items": [
                  {
                    "interactionId": "<string>",
                    "baseline": "<string>",
                    "candidate": "<string>"
                  }
                ],
                "omitted": 0
              },
              "stateChanged": true,
              "trajectoryChanged": true
            }
          }
        ],
        "omittedDetails": 0
      }
    },
    "githubReviewDelivery": {
      "schemaVersion": 1,
      "state": "pending",
      "commentExpected": true,
      "attempts": 50,
      "createdAtMs": 0,
      "updatedAtMs": 0,
      "checkRunId": "<string>",
      "checkUrl": "<string>",
      "commentId": "<string>",
      "commentUrl": "<string>",
      "lastErrorCode": "<string>",
      "finishedAtMs": 0
    },
    "policy": {
      "schemaVersion": 1,
      "sourceSide": "baseline",
      "sourceBuildHash": "<string>",
      "suiteKey": "<string>",
      "concurrency": 32,
      "drills": [
        {
          "drillId": "<string>",
          "targetId": "<string>",
          "classification": "contract",
          "trials": 5000,
          "retries": 5,
          "timeoutMs": 43200000
        }
      ],
      "logicalCases": 5000
    },
    "failure": {
      "schemaVersion": 1,
      "code": "<string>",
      "source": "framework",
      "message": "<string>",
      "retryable": true,
      "issues": [],
      "correlationId": "<string>",
      "details": {},
      "evidence": {
        "runId": "<string>",
        "sequence": 4503599627370495
      }
    },
    "finishedAtMs": 0
  },
  "case": {
    "schemaVersion": 1,
    "ciCaseId": "<string>",
    "ciSuiteId": "<string>",
    "side": "baseline",
    "buildHash": "<string>",
    "drillId": "<string>",
    "targetId": "<string>",
    "classification": "contract",
    "trial": 5000,
    "trialCount": 5000,
    "attempt": 5,
    "attemptLimit": 5,
    "seed": "<string>",
    "timeoutMs": 43200000,
    "state": "pending",
    "createdAtMs": 0,
    "updatedAtMs": 0,
    "sourceKind": "pinned_build",
    "revision": "<string>",
    "sessionId": "<string>",
    "hostedRunId": "<string>",
    "evidenceBundleId": "<string>",
    "verdict": "passed",
    "failure": {
      "schemaVersion": 1,
      "code": "<string>",
      "source": "framework",
      "message": "<string>",
      "retryable": true,
      "issues": [],
      "correlationId": "<string>",
      "details": {},
      "evidence": {
        "runId": "<string>",
        "sequence": 4503599627370495
      }
    },
    "finishedAtMs": 0
  },
  "claim": {
    "schemaVersion": 1,
    "ciClaimId": "<string>",
    "ciCaseId": "<string>",
    "runnerId": "<string>",
    "runId": "<string>",
    "expectedRunRevision": 0,
    "interaction": {
      "schemaVersion": 1,
      "interaction": {
        "id": "<string>",
        "afterStartUs": 0,
        "actorId": "<string>",
        "task": {
          "instruction": "<string>",
          "input": "<unknown>"
        },
        "actorInstanceId": "<string>"
      },
      "scheduledAtVirtualUs": 0,
      "startedAtVirtualUs": 0,
      "toolCallsAtStart": 0
    },
    "execution": {
      "schemaVersion": 1,
      "claimId": "<string>",
      "organizationId": "<string>",
      "projectId": "<string>",
      "hostedRunId": "<string>",
      "interactionId": "<string>",
      "expectedRunRevision": 4503599627370495,
      "runnerId": "<string>",
      "generation": 4503599627370495,
      "version": 0,
      "state": "reserved",
      "createdAtMs": 0,
      "updatedAtMs": 0,
      "expiresAtMs": 0,
      "simulationWorkId": "<string>",
      "startedAtMs": 0,
      "finishedAtMs": 0,
      "completionOperationId": "<string>"
    },
    "replayed": true,
    "expiresAtMs": 0
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "correlationId": "<string>",
  "retryable": true,
  "source": "platform",
  "retryAfterMs": 123,
  "operationId": "<string>",
  "issues": [
    {
      "path": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ],
  "details": {},
  "evidence": {
    "sessionId": "<string>",
    "runId": "<string>",
    "journalSeq": 4503599627370495,
    "buildHash": "<string>"
  }
}