---
title: "POST /api/{version}/organizations/{orgId}/agent-pools/{agentPoolId}/agents"
method: POST
path: "/api/{version}/organizations/{orgId}/agent-pools/{agentPoolId}/agents"
tags: ["AgentPools"]
---

# POST /api/{version}/organizations/{orgId}/agent-pools/{agentPoolId}/agents

`POST /api/{version}/organizations/{orgId}/agent-pools/{agentPoolId}/agents`

## Path parameters

- `orgId` string, required
- `agentPoolId` string, required
- `version` string, required

## Request body

- CreateAgentRequest
  - `name` string, nullable

## Response `200`

OK

- AgentDtoItemResponse
  - `item` AgentDto
    - `id` string, nullable
    - `name` string, nullable
    - `status` 'Unknown' | 'Up' | 'Down' | 'Stopped' | 'Running'
    - `lastSeenDate` string, date-time, nullable
    - `identity` string, nullable
    - `version` string, nullable
  - `links` HateoasLink[], nullable
    - `relation` string, nullable
    - `uri` string, nullable
    - `method` string, nullable

## Other responses

- `400` — Validation failed

---

[API](https://skmtc.net/data-grapes/apis/grapes-api.md) · [All operations](https://skmtc.net/data-grapes/apis/grapes-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/data-grapes/grapes-api/revisions/8ff77fe45bba/schema)