> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gol.network/llms.txt
> Use this file to discover all available pages before exploring further.

# Post v1agentsapicallsrequirements

> Connected agent session required. Available only when the Base Agent API runtime gate is enabled and verified.



## OpenAPI

````yaml /openapi/platform.json post /v1/agents/api/calls/requirements
openapi: 3.1.0
info:
  title: GOL Platform API
  description: >-
    Versioned GOL developer and consumer API. Consumer routes are mounted when
    their runtime integrations are configured.
  version: 0.8.0-rc.1
servers:
  - url: http://localhost:4100
    description: Local development
security: []
tags:
  - name: system
  - name: authentication
  - name: projects
  - name: api-keys
  - name: audit
  - name: gas-executions
  - name: gas-policies
  - name: webhooks
paths:
  /v1/agents/api/calls/requirements:
    post:
      tags:
        - Agent API
      description: >-
        Connected agent session required. Available only when the Base Agent API
        runtime gate is enabled and verified.
      operationId: prepareAgentApiCall
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentApiCallInput'
      responses:
        '200':
          description: Current authoritative state or accepted request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentApiCallRequirement'
        '400':
          description: Invalid request.
        '401':
          description: Session required.
        '403':
          description: Access denied.
        '409':
          description: Capability unavailable or conflict.
      security:
        - bearerAuth: []
components:
  schemas:
    AgentApiCallInput:
      type: object
      properties:
        providerId:
          type: string
        endpointId:
          type: string
        url:
          type: string
          format: uri
        body:
          type: string
          description: Optional UTF-8 request body for POST calls; maximum 65536 bytes.
        requestNonce:
          type: string
      required:
        - providerId
        - endpointId
        - url
        - requestNonce
    AgentApiCallRequirement:
      type: object
      properties:
        requirementId:
          type: string
        payload:
          type: string
          pattern: ^0x[0-9a-fA-F]{64}$
          description: >-
            EIP-712 digest of TransferWithAuthorization. Recompute from
            authorization and the live USDC DOMAIN_SEPARATOR before signing.
        signingVersion:
          type: integer
          enum:
            - 1
        chainId:
          type: integer
          enum:
            - 8453
            - 84532
          description: Agent-bound owner account chain; matches requirement.network.
        asset:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
          description: Canonical USDC token on chainId; matches requirement.asset.
        domainSeparator:
          type: string
          pattern: ^0x[0-9a-fA-F]{64}$
          description: >-
            DOMAIN_SEPARATOR read from asset when preparing the immutable
            requirement. Compare with an independent on-chain read.
        authorization:
          $ref: '#/components/schemas/AgentApiTransferAuthorization'
        requirement:
          $ref: '#/components/schemas/AgentApiPaymentRequirement'
        approvalRequired:
          type: boolean
        expiresAt:
          format: date-time
          type: string
      required:
        - requirementId
        - payload
        - signingVersion
        - chainId
        - asset
        - domainSeparator
        - authorization
        - requirement
        - approvalRequired
        - expiresAt
    AgentApiTransferAuthorization:
      type: object
      properties:
        from:
          pattern: ^0x[0-9a-fA-F]{40}$
          type: string
        to:
          pattern: ^0x[0-9a-fA-F]{40}$
          type: string
        value:
          pattern: ^(0|[1-9][0-9]*)$
          type: string
        validAfter:
          pattern: ^(0|[1-9][0-9]*)$
          type: string
        validBefore:
          type: string
          pattern: ^(0|[1-9][0-9]*)$
          description: >-
            Unix seconds bounded by requirement expiry and seller
            maxTimeoutSeconds.
        nonce:
          pattern: ^0x[0-9a-fA-F]{64}$
          type: string
      required:
        - from
        - to
        - value
        - validAfter
        - validBefore
        - nonce
    AgentApiPaymentRequirement:
      type: object
      properties:
        scheme:
          type: string
        network:
          type: string
        maxAmountRequired:
          type: string
          pattern: ^[1-9][0-9]*$
        asset:
          pattern: ^0x[0-9a-fA-F]{40}$
          type: string
        payTo:
          pattern: ^0x[0-9a-fA-F]{40}$
          type: string
        maxTimeoutSeconds:
          type: integer
        resource:
          type: string
        description:
          type: string
        mimeType:
          type: string
        extra:
          type: object
          additionalProperties: true
      required:
        - scheme
        - network
        - maxAmountRequired
        - asset
        - payTo
        - maxTimeoutSeconds
        - resource
        - description
        - mimeType
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Opaque owner, CLI, or agent session token. Agent tokens are accepted
        only where marked.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.