> ## Documentation Index > Fetch the complete documentation index at: https://docs.asteroid.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create Profile Group > Create a new profile group ## OpenAPI ````yaml https://odyssey.asteroid.ai/agents/v2/openapi.yaml post /agents/v2/profile-groups openapi: 3.1.0 info: title: Agent Service version: v1 servers: - url: https://odyssey.asteroid.ai security: - ApiKeyAuth: [] tags: - name: Agents - name: Environments - name: Schedules - name: Execution - name: Files - name: Profiles - name: Profile Groups - name: Agent Profiles - name: Agent Profile Pools - name: Workflows - name: Execution Batches - name: Scheduled Executions - name: Schema - name: Documentation - name: Context - name: Admin Customer Activity - name: Reference - name: Workflow Tags - name: Secrets - name: Vault - name: Insights - name: Workflow Versions paths: /agents/v2/profile-groups: post: tags: - Profile Groups summary: Create Profile Group description: Create a new profile group operationId: ProfileGroups_create requestBody: content: application/json: schema: $ref: >- #/components/schemas/Agents.Profile.CreateAgentProfilePoolRequest required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/Agents.Profile.AgentProfilePool' description: >- The request has succeeded and a new resource has been created as a result. '400': content: application/json: schema: $ref: '#/components/schemas/Common.BadRequestErrorBody' description: The server could not understand the request due to invalid syntax. '401': content: application/json: schema: $ref: '#/components/schemas/Common.UnauthorizedErrorBody' description: Access is unauthorized. '403': content: application/json: schema: $ref: '#/components/schemas/Common.ForbiddenErrorBody' description: Access is forbidden. '404': content: application/json: schema: $ref: '#/components/schemas/Common.NotFoundErrorBody' description: The server cannot find the requested resource. '500': content: application/json: schema: $ref: '#/components/schemas/Common.InternalServerErrorBody' description: Server error components: schemas: Agents.Profile.CreateAgentProfilePoolRequest: description: Request to create a new agent profile pool properties: allowConcurrentUse: default: false description: Whether multiple executions can use the same profile concurrently type: boolean name: description: Name of the agent profile pool (must be unique within organization) maxLength: 255 minLength: 1 type: string organizationId: allOf: - $ref: '#/components/schemas/Common.uuid' description: >- The ID of the organization that the pool belongs to. Defaults to the one organization the caller acts in, such as an API key's. Required when the caller belongs to several. selectionStrategy: allOf: - $ref: '#/components/schemas/Agents.Profile.SelectionStrategy' default: least_recently_used required: - name type: object Agents.Profile.AgentProfilePool: description: A pool of agent profiles that can be used for credential rotation properties: allowConcurrentUse: description: Whether multiple executions can use the same profile concurrently type: boolean createdAt: format: date-time type: string id: $ref: '#/components/schemas/Common.uuid' name: description: Name of the agent profile pool (unique within organization) type: string organizationId: allOf: - $ref: '#/components/schemas/Common.uuid' description: The ID of the organization that owns this pool selectionStrategy: $ref: '#/components/schemas/Agents.Profile.SelectionStrategy' updatedAt: format: date-time type: string required: - id - name - organizationId - selectionStrategy - allowConcurrentUse - createdAt - updatedAt type: object Common.BadRequestErrorBody: properties: code: enum: - 400 type: number x-enum-varnames: - BadRequest detail: description: Explanation of this occurrence. Same text as message type: string errors: description: The parameters that failed validation, when known items: $ref: '#/components/schemas/Common.FieldError' type: array instance: description: The request path that produced the problem type: string message: type: string status: format: int32 type: integer title: description: Short summary of the problem type type: string type: description: >- A URI that identifies the problem type. about:blank when the status says it all type: string required: - code - message type: object Common.UnauthorizedErrorBody: properties: code: enum: - 401 type: number x-enum-varnames: - Unauthorized detail: description: Explanation of this occurrence. Same text as message type: string instance: description: The request path that produced the problem type: string message: type: string status: format: int32 type: integer title: description: Short summary of the problem type type: string type: description: >- A URI that identifies the problem type. about:blank when the status says it all type: string required: - code - message type: object Common.ForbiddenErrorBody: properties: capability: description: The missing capability key, when reason is capability_required type: string code: enum: - 403 type: number x-enum-varnames: - Forbidden detail: description: Explanation of this occurrence. Same text as message type: string instance: description: The request path that produced the problem type: string message: type: string reason: allOf: - $ref: '#/components/schemas/Common.ForbiddenReason' description: Why the request was refused, when the client can act on it status: format: int32 type: integer title: description: Short summary of the problem type type: string type: description: >- A URI that identifies the problem type. about:blank when the status says it all type: string required: - code - message type: object Common.NotFoundErrorBody: properties: code: enum: - 404 type: number x-enum-varnames: - NotFound detail: description: Explanation of this occurrence. Same text as message type: string instance: description: The request path that produced the problem type: string message: type: string status: format: int32 type: integer title: description: Short summary of the problem type type: string type: description: >- A URI that identifies the problem type. about:blank when the status says it all type: string required: - code - message type: object Common.InternalServerErrorBody: properties: code: enum: - 500 type: number x-enum-varnames: - InternalServerError detail: description: Explanation of this occurrence. Same text as message type: string instance: description: The request path that produced the problem type: string message: type: string status: format: int32 type: integer title: description: Short summary of the problem type type: string type: description: >- A URI that identifies the problem type. about:blank when the status says it all type: string required: - code - message type: object Common.uuid: format: uuid type: string Agents.Profile.SelectionStrategy: description: Strategy for selecting an available profile from a pool enum: - least_recently_used - most_recently_used type: string Common.FieldError: description: A problem with one request parameter properties: detail: description: What is wrong with it type: string parameter: description: The query or path parameter name type: string required: - parameter - detail type: object Common.ForbiddenReason: enum: - capability_required type: string securitySchemes: ApiKeyAuth: in: header name: X-Api-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.