---
title: "Create Profile Group"
method: POST
path: "/agents/v2/profile-groups"
tags: ["Profile Groups"]
---

# Create Profile Group

`POST /agents/v2/profile-groups`

## Request

- Base URL: `https://odyssey.asteroid.ai`
- URL: `https://odyssey.asteroid.ai/agents/v2/profile-groups`
- Auth: API key in header `X-Api-Key`

Create a new profile group

## Request body

- AgentsProfileCreateAgentProfilePoolRequest: Request to create a new agent profile pool
  - `allowConcurrentUse` boolean: Whether multiple executions can use the same profile concurrently
  - `name` string, required: Name of the agent profile pool (must be unique within organization)
  - `organizationId` string, uuid
  - `selectionStrategy` 'least_recently_used' | 'most_recently_used': Strategy for selecting an available profile from a pool

## Response `201`

The request has succeeded and a new resource has been created as a result.

- AgentsProfileAgentProfilePool: A pool of agent profiles that can be used for credential rotation
  - `allowConcurrentUse` boolean, required: Whether multiple executions can use the same profile concurrently
  - `createdAt` string, date-time, required
  - `id` string, uuid, required
  - `name` string, required: Name of the agent profile pool (unique within organization)
  - `organizationId` string, uuid, required
  - `selectionStrategy` 'least_recently_used' | 'most_recently_used', required: Strategy for selecting an available profile from a pool
  - `updatedAt` string, date-time, required

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `500`: Server error

---

[API](https://skmtc.dev/asteroid/apis/agent-service.md) - [All operations](https://skmtc.dev/asteroid/apis/agent-service/llms.txt) - [OpenAPI document](https://skmtc.dev/asteroid/apis/agent-service/revisions/ccc134d1d510?raw)
