{
  "opencollection": "1.0.0",
  "info": {
    "name": "Computer-Use Agents Sessions API",
    "version": "1.0.0"
  },
  "items": [
    {
      "info": {
        "name": "Sessions",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List Sessions",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions",
            "params": [
              {
                "name": "owner",
                "value": "",
                "type": "query"
              },
              {
                "name": "status",
                "value": "",
                "type": "query"
              },
              {
                "name": "agent",
                "value": "",
                "type": "query"
              },
              {
                "name": "group_id",
                "value": "",
                "type": "query"
              },
              {
                "name": "parent_session_id",
                "value": "",
                "type": "query"
              },
              {
                "name": "schedule_id",
                "value": "",
                "type": "query",
                "description": "Only sessions created by this schedule."
              },
              {
                "name": "search",
                "value": "",
                "type": "query",
                "description": "Case-insensitive match on the session's first message or answer."
              },
              {
                "name": "created_before",
                "value": "",
                "type": "query"
              },
              {
                "name": "created_after",
                "value": "",
                "type": "query"
              },
              {
                "name": "finished_before",
                "value": "",
                "type": "query"
              },
              {
                "name": "finished_after",
                "value": "",
                "type": "query"
              },
              {
                "name": "page",
                "value": "",
                "type": "query",
                "description": "Page number (1-based)"
              },
              {
                "name": "size",
                "value": "",
                "type": "query",
                "description": "Number of items per page"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query",
                "description": "Sort by field"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "List sessions visible to ``user``."
        },
        {
          "info": {
            "name": "Create Session",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions",
            "headers": [
              {
                "name": "Idempotency-Key",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Create an agentic session."
        },
        {
          "info": {
            "name": "Get Session Quota",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/quota",
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Concurrent-session quota for the authenticated user."
        },
        {
          "info": {
            "name": "Get Session",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get a session."
        },
        {
          "info": {
            "name": "Cancel Session",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Cancel the session."
        },
        {
          "info": {
            "name": "Get Session Status",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/status",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Get a session's live status."
        },
        {
          "info": {
            "name": "Send Session Messages",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/messages",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Send a user message (single or batch)."
        },
        {
          "info": {
            "name": "Send Session Tool Results",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/tool_results",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Send results for custom tool calls (single or batch)."
        },
        {
          "info": {
            "name": "Pause Session",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/pause",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Pause the session."
        },
        {
          "info": {
            "name": "Resume Session",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/resume",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Resume the session."
        },
        {
          "info": {
            "name": "Force Session Answer",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/force_answer",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Ask the agent to emit a final answer on its next step."
        },
        {
          "info": {
            "name": "Get Session Changes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/changes",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              },
              {
                "name": "from_index",
                "value": "",
                "type": "query"
              },
              {
                "name": "limit",
                "value": "",
                "type": "query"
              },
              {
                "name": "include_events",
                "value": "",
                "type": "query"
              },
              {
                "name": "wait_for_seconds",
                "value": "",
                "type": "query"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Long-poll for new events since ``from_index``; 204 if none arrive within ``wait_for_seconds``."
        },
        {
          "info": {
            "name": "List Session Events",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/events",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              },
              {
                "name": "page",
                "value": "",
                "type": "query"
              },
              {
                "name": "size",
                "value": "",
                "type": "query"
              },
              {
                "name": "sort",
                "value": "",
                "type": "query"
              },
              {
                "name": "type",
                "value": "",
                "type": "query"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Paginated event history. Use ``/changes`` for live tailing."
        },
        {
          "info": {
            "name": "Submit Session Feedback",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/feedback",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Record semantic-success feedback on the whole session."
        },
        {
          "info": {
            "name": "Submit Event Feedback",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/events/:event_index/feedback",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              },
              {
                "name": "event_index",
                "value": "",
                "type": "path"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            },
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Record feedback on a single event in the session's history."
        },
        {
          "info": {
            "name": "Share Session",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/share",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Make the session publicly readable; returns the share URL path."
        },
        {
          "info": {
            "name": "Unshare Session",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/share",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Revoke public access to the session."
        },
        {
          "info": {
            "name": "Get Session Resource",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://agp.eu.hcompany.ai/api/v2/sessions/:id/resources/:bucket/:key",
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path"
              },
              {
                "name": "bucket",
                "value": "",
                "type": "path"
              },
              {
                "name": "key",
                "value": "",
                "type": "path"
              }
            ],
            "auth": {
              "type": "bearer",
              "token": "{{bearerToken}}"
            }
          },
          "docs": "Redirect to a presigned S3 URL for a session-owned resource."
        }
      ]
    }
  ],
  "bundled": true
}