SKskyfire

Create Agent Group

Changed on

As an Organization Admin, create an agent group in your organization.

post/api/v1/agent-groups

Request

  • Base URL
    https://api.skyfire.xyz
  • URL
    https://api.skyfire.xyz/api/v1/agent-groups
  • Auth
    API key in header skyfire-api-key

Request body

namestring required

Name of the group. Printable ASCII with at least one non-space character, 1 to 100 characters. Unique in your organization after case and whitespace folding, and may not match an active ungrouped agent's name. Member agents take this name. e.g. "ShoppingBot"

descriptionstring

Free-form description of what this agent does. At most 1000 characters.

Response

Ok

idstring required

Unique identifier of the agent group. Use it on the by-id, enrollment, and member routes.

namestring required

The group's name, as stored.

descriptionstring nullable required

The description provided at creation, or null.

activeboolean required

Whether the group is active. Always true on creation.

createdAtstring required

When the group was created. e.g. "2026-10-01T15:21:07.000Z".

updatedAtstring required

When the group was last changed.

Changes