> ## 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 v1agentsapicalls relay

> 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/{requirementId}/relay
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/{requirementId}/relay:
    post:
      tags:
        - Agent API
      description: >-
        Connected agent session required. Available only when the Base Agent API
        runtime gate is enabled and verified.
      operationId: relayAgentApiCall
      parameters:
        - name: requirementId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                signature:
                  type: string
                  pattern: ^0x(?:[0-9a-fA-F]{2})+$
              required:
                - signature
      responses:
        '200':
          description: Current authoritative state or accepted request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentApiCallStatus'
        '400':
          description: Invalid request.
        '401':
          description: Session required.
        '403':
          description: Access denied.
        '409':
          description: Capability unavailable or conflict.
      security:
        - bearerAuth: []
components:
  schemas:
    AgentApiCallStatus:
      type: object
      properties:
        requirementId:
          type: string
        state:
          type: string
          enum:
            - available
            - submitting
            - reported
            - resolved
            - expired
            - unavailable
            - awaiting_approval
            - indeterminate
            - settled
            - declined
        approval:
          type: string
          enum:
            - open
            - approved
            - declined
            - expired
          nullable: true
        resolution:
          $ref: '#/components/schemas/AgentApiCallResolution'
          nullable: true
        report:
          $ref: '#/components/schemas/AgentApiCallReport'
          nullable: true
        evidence:
          $ref: '#/components/schemas/AgentApiCallResolution'
      required:
        - requirementId
        - state
    AgentApiCallResolution:
      oneOf:
        - type: object
          properties:
            kind:
              type: string
              enum:
                - settled
            txHash:
              pattern: ^0x[0-9a-fA-F]{64}$
              type: string
            blockNumber:
              pattern: ^(0|[1-9][0-9]*)$
              type: string
            blockHash:
              pattern: ^0x[0-9a-fA-F]{64}$
              type: string
          required:
            - kind
            - txHash
            - blockNumber
            - blockHash
        - type: object
          properties:
            kind:
              type: string
              enum:
                - expired
            blockNumber:
              pattern: ^(0|[1-9][0-9]*)$
              type: string
            blockHash:
              pattern: ^0x[0-9a-fA-F]{64}$
              type: string
          required:
            - kind
            - blockNumber
            - blockHash
        - type: object
          properties:
            kind:
              type: string
              enum:
                - unavailable
            reason:
              type: string
              enum:
                - cancelled
                - used_elsewhere
            txHash:
              pattern: ^0x[0-9a-fA-F]{64}$
              type: string
            blockNumber:
              pattern: ^(0|[1-9][0-9]*)$
              type: string
            blockHash:
              pattern: ^0x[0-9a-fA-F]{64}$
              type: string
          required:
            - kind
            - reason
            - txHash
            - blockNumber
            - blockHash
    AgentApiCallReport:
      type: object
      properties:
        providerStatus:
          type: integer
          nullable: true
        response: {}
      required:
        - providerStatus
  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.