---
title: "Get handoff"
method: POST
path: "/v1/commands/get_handoff"
tags: ["Link monitoring and evidence"]
---

# Get handoff

`POST /v1/commands/get_handoff`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/commands/get_handoff`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Shared command transport. All logical arguments in JSON; no query or Idempotency-Key header. See canonical operation reference.

## Headers

- `X-Workspace-ID` string

## Request body

- GetHandoffInput
  - `projectId` string, required: project ID from create/list.
  - `handoff` 'disavow_upload', required

## Response `200`

Command result, including queued admission.

- GetHandoffOutput
  - `id` 'disavow_upload', required: Resource identifier returned by the operation.
  - `title` string, required
  - `why` string, required
  - `prompt` string, required
  - `steps` object[], required
    - `text` string, required
    - `href` string, uri
    - `action` 'download' | 'verify'
  - `agent` object, required
    - `goal` string, required
    - `needs` string[], required
    - `procedure` string[], required
    - `verify` object, required
      - `command` string, required
      - `input` string, required
    - `stop_if` string[], required
    - `never` string[], required
  - `website` object, required
    - `project_id` string, required: Project that owns this record.
    - `domain` string, required
  - `status` object, required: Resource lifecycle status.
    - `project_id` string, required: Project that owns this record.
    - `rules` object, required
      - `active` integer, required
      - `effective` integer, required
      - `domains` integer, required
      - `urls` integer, required
    - `changed_since_download` integer, nullable, required
    - `last_change_at` string, nullable, required
    - `last_download` object, nullable, required
      - `id` string, required: Resource identifier returned by the operation.
      - `workspace_id` string, required: Workspace that owns this record.
      - `project_id` string, required: Project that owns this record.
      - `format_version` 1, required
      - `sha256` string, required
      - `stored_active_count` integer, required
      - `effective_count` integer, required
      - `byte_length` integer, required
      - `collection_revision` integer, required
      - `source_revisions` object[], required
        - `id` string, required: Resource identifier returned by the operation.
        - `revision` integer, required: Optimistic concurrency revision; supply it as expectedRevision on the next write.
      - `created_by` string, required
      - `created_at` string, required: UTC timestamp when the record was created.
      - `exported_by_label` 'you' | 'owner' | 'admin' | 'member' | 'viewer' | 'former member'
    - `google` object, required
      - `state` 'never_checked' | 'in_sync' | 'behind' | 'differs' | 'counts_only', required: Saved lifecycle or evidence state, as enumerated for this record.
      - `changes_since_check` integer, nullable, required
      - `last_check` object, nullable, required
        - `id` string, required: Resource identifier returned by the operation.
        - `checked_at` string, required: UTC timestamp of the saved check.
        - `method` 'text' | 'counts', required
        - `result` 'match' | 'differs' | 'counts_match' | 'counts_differ', required: Saved result; null when this operation has no completed result.
        - `missing_in_google` integer, required
        - `extra_in_google` integer, required
        - `examples` object, required
          - `missing_in_google` string[], required
          - `extra_in_google` string[], required
        - `google` object, required
          - `domains` integer, required
          - `urls` integer, required
        - `uploaded_on` string, nullable, required
        - `checked_by` 'person' | 'agent', required

## Other responses

- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/1bf30c2912b2?raw)