Hexel StudioDocs

API referenceConsole

List agents

GET/registry/v1/agents

List agents with optional filters

Query parameters

authoroptional string

Filter by author

statusoptional string

Filter by status

limitoptional integerdefault: 20

Limit

offsetoptional integerdefault: 0

Offset

Returns

200OKAgentsListResponse

agentsoptional array of Agent

18 properties of Agent

allowed_org_idsoptional array of string

authoroptional string

capabilitiesoptional array of string

created_atoptional string

descriptionoptional string

endpointoptional string

idoptional string

imageoptional string

image_pull_secretoptional ImagePullSecret

3 properties of ImagePullSecret

passwordoptional string

registryoptional string

usernameoptional string

manifestoptional AgentManifest

10 properties of AgentManifest

authenticationoptional object

capabilitiesoptional object

descriptionoptional string

input_schemaoptional object

nameoptional string

output_schemaoptional object

runtimeoptional object

skillsoptional array of ManifestSkill

3 properties of ManifestSkill

idoptional string

inputModesoptional array of string

outputModesoptional array of string

urloptional string

versionoptional string

metadataoptional map[string]

nameoptional string

org_idoptional string

public_keyoptional string

stateoptional string

registered, deploying, running, active, idle, sleeping, stopped, failed

updated_atoptional string

versionoptional string

visibilityoptional string

private, public

totaloptional integer

Errors

500Internal Server Error

GET Request

curl --request GET \
  --url 'https://compute.hexelstudio.com/registry/v1/agents'

const res = await fetch("https://compute.hexelstudio.com/registry/v1/agents", {
  method: "GET",
})
const data = await res.json()

import os
import requests

res = requests.get(
    "https://compute.hexelstudio.com/registry/v1/agents",
)
data = res.json()

Response

{
  "agents": [
    {
      "allowed_org_ids": [
        "string"
      ],
      "author": "string",
      "capabilities": [
        "string"
      ],
      "created_at": "2026-01-01T00:00:00Z",
      "description": "string",
      "endpoint": "string",
      "id": "string",
      "image": "string",
      "image_pull_secret": {
        "password": "string",
        "registry": "string",
        "username": "string"
      },
      "manifest": {
        "authentication": {},
        "capabilities": {},
        "description": "string",
        "input_schema": {},
        "name": "string",
        "output_schema": {},
        "runtime": {},
        "skills": [
          {
            "id": "string",
            "inputModes": [
              "string"
            ],
            "outputModes": [
              "string"
            ]
          }
        ],
        "url": "string",
        "version": "string"
      },
      "metadata": {
        "key": "string"
      },
      "name": "string",
      "org_id": "string",
      "public_key": "string",
      "state": "string",
      "updated_at": "2026-01-01T00:00:00Z",
      "version": "string",
      "visibility": "string"
    }
  ],
  "total": 0
}

{
  "error": "string",
  "message": "string"
}