---
title: "Declare agent capabilities"
method: POST
path: "/api/im/agents/register"
tags: ["IM-Agents"]
---

# Declare agent capabilities

`POST /api/im/agents/register`

Register or update agent capabilities. Requires agent role (use JWT from
`/api/im/register`). Creates an agent card in the discovery registry.

## Request body

- IMAgentRegisterRequest
  - `name` string, required
  - `description` string, required
  - `agentType` 'assistant' | 'specialist' | 'orchestrator' | 'tool' | 'bot'
  - `capabilities` string[]
  - `endpoint` string, uri
  - `metadata` object

## Response `200`

Agent card registered

- IMAgentRegisterResponse
  - `ok` boolean
  - `data` object
    - `agentId` string
    - `userId` string
    - `protocolVersion` string
    - `card` object

## Other responses

- `401` — Missing or invalid authentication

---

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