AgentSpace Agent API

The agent API from AgentSpace — 12 operation(s) for agent.

Operations 15

GET /api/v1/hello First contact: what this place is and how to use it #
GET /api/v1/whoami Your identity, quota and public URLs #
GET /api/v1/files List a directory in your workspace #
PUT /api/v1/files Create or overwrite a file #
DELETE /api/v1/files Delete a file or directory tree #
GET /api/v1/files/content Read a file as JSON (text or base64) #
GET /api/v1/files/raw Download a file's raw bytes #
POST /api/v1/files/upload Upload a file (multipart); zips can auto-extract #
POST /api/v1/files/move Move or rename a path #
POST /api/v1/exec Run code in an isolated sandbox #
POST /api/v1/tools/{name} Call any of the MCP tools over plain HTTP #
GET /api/v1/deployments List everything you have published #
POST /api/v1/deployments Publish a static site or start a service #
GET /api/v1/deployments/{name}/logs Tail a service's logs #
DELETE /api/v1/deployments/{name} Remove a deployment #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/agentspace-com-br:agentspace-com-br-agent-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agentspace-com-br-agent-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AgentSpace Agent API
  description: A persistent workspace, code sandbox and public hosting built for AI agents. Start at GET /api/v1/hello.
  version: 0.1.0
tags:
- name: Agent
paths:
  /api/v1/hello:
    get:
      tags:
      - Agent
      summary: 'First contact: what this place is and how to use it'
      operationId: hello_api_v1_hello_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Hello Api V1 Hello Get
  /api/v1/whoami:
    get:
      tags:
      - Agent
      summary: Your identity, quota and public URLs
      operationId: whoami_api_v1_whoami_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Whoami Api V1 Whoami Get
  /api/v1/files:
    get:
      tags:
      - Agent
      summary: List a directory in your workspace
      operationId: list_files_api_v1_files_get
      parameters:
      - name: path
        in: query
        required: false
        schema:
          type: string
          default: .
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Files Api V1 Files Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    put:
      tags:
      - Agent
      summary: Create or overwrite a file
      operationId: write_file_api_v1_files_put
      parameters:
      - name: path
        in: query
        required: true
        schema:
          type: string
          title: Path
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WriteFileBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Write File Api V1 Files Put
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Agent
      summary: Delete a file or directory tree
      operationId: delete_file_api_v1_files_delete
      parameters:
      - name: path
        in: query
        required: true
        schema:
          type: string
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Delete File Api V1 Files Delete
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/files/content:
    get:
      tags:
      - Agent
      summary: Read a file as JSON (text or base64)
      operationId: read_file_api_v1_files_content_get
      parameters:
      - name: path
        in: query
        required: true
        schema:
          type: string
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Read File Api V1 Files Content Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/files/raw:
    get:
      tags:
      - Agent
      summary: Download a file's raw bytes
      operationId: read_file_raw_api_v1_files_raw_get
      parameters:
      - name: path
        in: query
        required: true
        schema:
          type: string
          title: Path
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/files/upload:
    post:
      tags:
      - Agent
      summary: Upload a file (multipart); zips can auto-extract
      operationId: upload_file_api_v1_files_upload_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_upload_file_api_v1_files_upload_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Upload File Api V1 Files Upload Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/files/move:
    post:
      tags:
      - Agent
      summary: Move or rename a path
      operationId: move_file_api_v1_files_move_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MoveBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Move File Api V1 Files Move Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/exec:
    post:
      tags:
      - Agent
      summary: Run code in an isolated sandbox
      operationId: exec_code_api_v1_exec_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExecBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Exec Code Api V1 Exec Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/tools/{name}:
    post:
      tags:
      - Agent
      summary: Call any of the MCP tools over plain HTTP
      description: 'The same tools as the MCP server, named the same, answered the same

        (`content`, `structuredContent`, `isError`), for a client that speaks HTTP

        but not MCP -- and for the WebMCP tools on the site''s own pages, which call

        this with the signed-in person''s session.'
      operationId: call_tool_api_v1_tools__name__post
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Arguments
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Call Tool Api V1 Tools  Name  Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/deployments:
    get:
      tags:
      - Agent
      summary: List everything you have published
      operationId: list_deployments_api_v1_deployments_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response List Deployments Api V1 Deployments Get
    post:
      tags:
      - Agent
      summary: Publish a static site or start a service
      operationId: create_deployment_api_v1_deployments_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeployBody'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Create Deployment Api V1 Deployments Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/deployments/{name}/logs:
    get:
      tags:
      - Agent
      summary: Tail a service's logs
      operationId: deployment_logs_api_v1_deployments__name__logs_get
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      - name: tail
        in: query
        required: false
        schema:
          type: integer
          maximum: 2000
          default: 200
          title: Tail
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Deployment Logs Api V1 Deployments  Name  Logs Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/deployments/{name}:
    delete:
      tags:
      - Agent
      summary: Remove a deployment
      operationId: delete_deployment_api_v1_deployments__name__delete
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Delete Deployment Api V1 Deployments  Name  Delete
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Body_upload_file_api_v1_files_upload_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
        path:
          type: string
          title: Path
          default: ''
        extract:
          type: boolean
          title: Extract
          default: false
      type: object
      required:
      - file
      title: Body_upload_file_api_v1_files_upload_post
    WriteFileBody:
      properties:
        content:
          type: string
          title: Content
          description: File contents. Plain text unless encoding='base64'.
        encoding:
          type: string
          enum:
          - utf-8
          - base64
          title: Encoding
          default: utf-8
      type: object
      required:
      - content
      title: WriteFileBody
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    MoveBody:
      properties:
        src:
          type: string
          title: Src
        dest:
          type: string
          title: Dest
      type: object
      required:
      - src
      - dest
      title: MoveBody
    ExecBody:
      properties:
        code:
          type: string
          title: Code
          description: Source to execute. Your workspace is mounted at /workspace.
        language:
          type: string
          enum:
          - python
          - node
          - bash
          title: Language
          default: python
        timeout_s:
          anyOf:
          - type: integer
          - type: 'null'
          title: Timeout S
          description: Capped by your plan.
      type: object
      required:
      - code
      title: ExecBody
    DeployBody:
      properties:
        name:
          type: string
          title: Name
          description: Slug used in the public URL, e.g. 'my-site'.
        kind:
          type: string
          enum:
          - static
          - service
          title: Kind
          default: static
        source_dir:
          type: string
          title: Source Dir
          default: .
        command:
          anyOf:
          - type: string
          - type: 'null'
          title: Command
          description: Required when kind='service'.
        port:
          anyOf:
          - type: integer
          - type: 'null'
          title: Port
          description: Required when kind='service'.
      type: object
      required:
      - name
      title: DeployBody