{
  "authentication": {
    "authorization_header": "Authorization: Bearer <token>",
    "machine_agent": {
      "identity": "external_agent service principal",
      "provisioning": "A Space manager creates the service principal, grants the Space, and issues its scoped token.",
      "required_for": [
        "remote MCP",
        "autonomous REST jobs"
      ]
    },
    "scheme": "Bearer",
    "space_header": "X-Colter-Workspace: <space-slug>",
    "user_delegated_agent": {
      "device_authorization": "https://api.colter.ai/api/v2/auth/device",
      "required_for": [
        "master-agent conversations",
        "user-attributed CLI work"
      ],
      "token_exchange": "https://api.colter.ai/api/v2/auth/device/token"
    },
    "wallet_agent": {
      "challenge": "https://api.colter.ai/api/x402/v1/wallets/challenge",
      "identity": "wallet service principal (EIP-191 challenge signature)",
      "required_for": [
        "wallet-native purchases, no account required"
      ],
      "verify": "https://api.colter.ai/api/x402/v1/wallets/verify"
    }
  },
  "contract": "agent-entry",
  "contract_version": "1",
  "description": "Services your agent can hire: discover a service, authorize its scope and price, then review the result, evidence, and receipt. The caller retains its ongoing responsibility.",
  "documentation": {
    "agent_instructions": "https://colter.ai/docs/agents",
    "availability": "The work check (work_check below) is self-service; its availability is live. Other account services remain an approved-account pilot configured during setup.",
    "connect": "https://colter.ai/docs/quickstart#connect",
    "llms_txt": "https://colter.ai/llms.txt",
    "openapi": "https://colter.ai/assets/colter-jobs-openapi.json",
    "postman_collection": "https://colter.ai/assets/colter-jobs.postman_collection.json",
    "work_check": "https://colter.ai/check"
  },
  "entrypoints": {
    "agent": "https://colter.ai/agent",
    "api_origin": "https://api.colter.ai",
    "well_known": "https://colter.ai/.well-known/colter"
  },
  "flows": {
    "machine_agent": [
      {
        "method": "GET",
        "required_scope": "services:read",
        "step": "discover",
        "url": "https://api.colter.ai/api/v2/services"
      },
      {
        "method": "POST",
        "required_scope": "quotes:write",
        "step": "request_bid",
        "url": "https://api.colter.ai/api/v2/quotes"
      },
      {
        "method": "POST",
        "required_scope": "quotes:write",
        "step": "authorize",
        "url": "https://api.colter.ai/api/v2/quotes/:quote_key/accept"
      },
      {
        "method": "GET",
        "required_scope": "jobs:read",
        "step": "observe",
        "url": "https://api.colter.ai/api/v2/jobs/:job_key"
      },
      {
        "method": "GET",
        "required_scope": "jobs:read",
        "step": "collect_outcome",
        "url": "https://api.colter.ai/api/v2/jobs/:job_key/outcome"
      }
    ],
    "user_delegated_agent": [
      {
        "method": "POST",
        "required_scope": null,
        "step": "authenticate",
        "url": "https://api.colter.ai/api/v2/auth/device"
      },
      {
        "method": "GET",
        "required_scope": "colter:read",
        "step": "discover_commands",
        "url": "https://api.colter.ai/api/v2/commands"
      },
      {
        "method": "POST",
        "required_scope": "colter:write",
        "step": "open_conversation",
        "url": "https://api.colter.ai/api/v2/colter/conversations"
      }
    ],
    "wallet_agent": [
      {
        "method": "GET",
        "required_scope": null,
        "step": "browse_catalog",
        "url": "https://api.colter.ai/api/catalog/v1/services"
      },
      {
        "method": "POST",
        "required_scope": null,
        "step": "challenge",
        "url": "https://api.colter.ai/api/x402/v1/wallets/challenge"
      },
      {
        "method": "POST",
        "required_scope": null,
        "step": "verify",
        "url": "https://api.colter.ai/api/x402/v1/wallets/verify"
      },
      {
        "method": "POST",
        "required_scope": "quotes:write",
        "step": "request_bid",
        "url": "https://api.colter.ai/api/x402/v1/quotes"
      },
      {
        "method": "POST",
        "required_scope": "quotes:write",
        "step": "pay_and_accept",
        "url": "https://api.colter.ai/api/x402/v1/quotes/:quote_key/accept"
      },
      {
        "method": "GET",
        "required_scope": "jobs:read",
        "step": "observe",
        "url": "https://api.colter.ai/api/x402/v1/jobs/:job_key"
      },
      {
        "method": "GET",
        "required_scope": "jobs:read",
        "step": "collect_outcome",
        "url": "https://api.colter.ai/api/x402/v1/jobs/:job_key/outcome"
      }
    ]
  },
  "governance": {
    "authority": "Colter Core owns identity, quotes, approvals, Jobs, Runs, usage, outcomes, and receipts.",
    "delegated_auto_accept": "Allowed only when the machine service principal has sufficient per-job and daily spend authority.",
    "idempotency": "Use Idempotency-Key on mutating transactional requests.",
    "ordinary_quote_request_starts_work": false,
    "work_authorization": "A quote must be explicitly accepted unless a predelegated auto_accept policy permits the request. Machine acceptance is always bounded by the principal's per-job and daily spend limits."
  },
  "interfaces": {
    "mcp": {
      "buyer_profile": "Focused hiring tools filtered by machine-token scopes. Existing authority and spending rules still apply; human review uses the customer app or user-authenticated REST.",
      "buyer_url": "https://api.colter.ai/mcp?profile=buyer",
      "discovery_method": "tools/list",
      "protocol_version": "2025-06-18",
      "transport": "streamable-http",
      "url": "https://api.colter.ai/mcp"
    },
    "rest": {
      "base_url": "https://api.colter.ai/api/v2",
      "command_discovery": "https://api.colter.ai/api/v2/commands",
      "media_type": "application/json"
    }
  },
  "payments": {
    "activity": "https://colter.ai/api/catalog/v1/activity",
    "catalog": "https://colter.ai/api/catalog/v1/services",
    "payment_headers": [
      "X-PAYMENT",
      "PAYMENT-SIGNATURE"
    ],
    "payment_point": "quote acceptance (execution starts only after settlement)",
    "protocol": "x402",
    "refunds": "A prepaid job that fails or is canceled refunds as wallet credit, consumed by the wallet's next acceptance.",
    "x402_version": 2
  },
  "service": "colter",
  "start": {
    "mcp": {
      "method": "tools/list",
      "url": "https://api.colter.ai/mcp?profile=buyer"
    },
    "rest": "https://api.colter.ai/api/v2/services"
  },
  "work_check": {
    "availability": {
      "price": {
        "amount_microcents": 500000000,
        "currency": "USD",
        "pricing_status": "approved"
      },
      "purchasable_rails": [],
      "reasons": [
        "no_payment_rail_available"
      ],
      "registrations": {
        "state": "open"
      },
      "state": "unavailable"
    },
    "buyer_interface": "https://api.colter.ai/api/agent/v1",
    "contract": "https://api.colter.ai/api/agent/v1/services/colter_work_check",
    "contract_version": "colter.work_check.v1",
    "instructions": "https://colter.ai/docs/agents",
    "mcp": "https://api.colter.ai/mcp?profile=buyer",
    "name": "Check an agent's work",
    "page": "https://colter.ai/check",
    "purchase": {
      "method": "POST",
      "url": "https://api.colter.ai/api/agent/v1/checks"
    },
    "receipt_certifies_work": false,
    "registration": {
      "method": "POST",
      "url": "https://api.colter.ai/api/agent/v1/registrations"
    },
    "service_key": "colter_work_check"
  }
}