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

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

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

## Path parameters

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

## Request body

- CreateAgentPoolRequest
  - `name` string, nullable
  - `description` string, nullable

## Response `200`

OK

- AgentPoolDtoItemResponse
  - `item` AgentPoolDto
    - `id` string, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `type` 'GrapesAgent' | 'SelfHosted'
  - `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)