Create

POST 
/agents

Create a new agent in the AgentStation platform.

Request

application/json

Body

required

name stringrequired

The name of the agent.

description stringrequired

A brief description of the agent.

type AgentType (string)required

Possible values: [human, ai]

The type of agent.

workspace_id uidrequired

The UID associated to a Workspace. Learn more

Responses

200

Create-Agent action successful

application/json

Schema

Schema

id uidrequired

The UID associated to an Agent. Learn more

name stringrequired

The name of the agent.

description stringrequired

A brief description of the agent.

type AgentType (string)required

Possible values: [human, ai]

The type of agent.

workspace

object

required

id uidrequired

The UID associated to a Workspace. Learn more

status WorkspaceStatus (string)required

Possible values: [active, archived]

The status of the Workspace.

files

object

object string

Possible values: [list]

data

object[]

Array [

id uuidrequired

The UUID associated to a file.

name stringrequired

The name of the file.

url urirequired

URL to download the file contents.

size integerrequired

The size of the file in bytes.

createdAt date-timerequired

The creation time of the file.

]

logs

object

object string

Possible values: [list]

data

object[]

Array [

id uuidrequired

The UUID associated to a log.

type stringrequired

The type of log.

level LogLevel (string)required

Possible values: [debug, info, warning, error]

The log level.

url uri

URL to download the file contents.

createdAt date-timerequired

The creation time of the log.

]

createdAt date-timerequired

The creation time of the Workspace.

createdAt date-timerequired

The creation time of the agent.

Example (from schema)

{
  "id": "6R4fLjzt",
  "name": "Alice",
  "description": "A friendly AI assistant.",
  "type": "ai",
  "workspace": {
    "id": "bMf1euMgczAY",
    "status": "active",
    "createdAt": "2021-04-07T10:30:00Z"
  },
  "createdAt": "2021-04-07T10:30:00Z"
}

400

Invalid Request Format - check API documentation for proper syntax.

application/json

Schema

Schema

error string
message string

Example (from schema)

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

401

Unauthorized - missing or invalid API key.

application/json

Schema

Schema

error string
message string

Example (from schema)

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

402

Payment Required - you have run out of trial credits or your payment method has expired. Please add payment details to your account.

application/json

Schema

Schema

error string
message string

Example (from schema)

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

422

Unprocessable Entity - cannot find requested asset associated with your API key.

application/json

Schema

Schema

error string
message string

Example (from schema)

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

429

Too Many Requests - you have exceeded the rate limit for your account. Please wait before making additional requests.

application/json

Schema

Schema

error string
message string

Example (from schema)

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

500

Internal Server Error - please retry your request.

application/json

Schema

Schema

error string
message string

Example (from schema)

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

503

Service Unavailable - our servers have dropped the request due to high load - please retry.

application/json

Schema

Schema

error string
message string

Example (from schema)

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

Loading...