Agents Create | SignalCore

import requests
url = "https://signalcore.ai/v1/squads/squad_id/agents"
payload = { "name": "name" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": "id",
  "squad_id": "squad_id",
  "name": "name",
  "role": "role",
  "description": "description",
  "instructions": "instructions",
  "model": "model",
  "actions": [
    "actions"
  ],
  "needs_approval": [
    "needs_approval"
  ],
  "access": {
    "key": "value"
  },
  "icon": "sparkle",
  "about_at": "2024-01-15T09:30:00Z",
  "is_builder": true,
  "voice": {
    "language": "language",
    "voice": {
      "provider": "elevenlabs",
      "id": "id"
    },
    "first_message": "first_message",
    "max_duration_s": 1,
    "end_call_phrases": [
      "end_call_phrases"
    ],
    "model": "claude-haiku-5-5",
    "record": true
  },
  "timezone": "timezone",
  "packages": {
    "apt": [
      "apt"
    ],
    "pip": [
      "pip"
    ]
  },
  "created_at": "2024-01-15T09:30:00Z",
  "approvals": {
    "key": "never"
  }
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

squad_idstringRequired

Request

This endpoint expects an object.

namestringRequired1-120 characters

rolestringOptional<=120 charactersDefaults to

descriptionstringOptional<=2000 charactersDefaults to

instructionsstringOptional<=50000 charactersDefaults to

modelstring or nullOptional

iconenum or nullOptional

Response

Successful Response

idstring

squad_idstring

namestring

rolestring

descriptionstring

instructionsstring

modelstring

actionslist of strings

needs_approvallist of strings

accessmap from strings to any

iconenum or null

about_atdatetime or null

is_builderboolean

voiceobject

How an agent talks on a call (VOICE.md). The defaults are the old product’s, in Spanish: its ElevenLabs voice (Carolina, from Spain), up to ten minutes, a goodbye ends it.

timezonestring

packagesobject

What an agent’s own code needs besides the platform, installed exactly as declared (environments.py): Debian packages (apt: ffmpeg, poppler-utils) and Python requirements (pip: openpyxl==3.1.5, pinned so a new release never changes what runs). The manifest checks each (manifest.read_packages).

created_atdatetime

approvalsmap from strings to enumsOptional

Allowed values:

Errors

422

Squads Agents Create Request Unprocessable Entity Error

Authentication

Path parameters

Headers

Request

Response

Errors