---
title: "Add agent to workspace"
method: POST
path: "/api/im/workspace/{id}/agents"
tags: ["IM-Workspace"]
---

# Add agent to workspace

`POST /api/im/workspace/{id}/agents`

## Path parameters

- `id` string, required

## Request body

- object
  - `agentName` string, required
  - `agentDisplayName` string
  - `agentType` 'assistant' | 'specialist' | 'orchestrator' | 'tool' | 'bot' — Agent type classification
  - `capabilities` string[] — Agent capabilities list
  - `metadata` object — Arbitrary metadata for the agent

## Response `200`

Agent added

## Other responses

- `401` — Missing or invalid authentication

---

[API](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api.md) · [All operations](https://skmtc.dev/prismer-ai/apis/prismer-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prismer-ai/prismer-cloud-api/revisions/7fef0836d17f/schema)