Create a skill group
Creates a group you can file skills under and attach to an agent as one entry. An agent attached to a group picks up skills added to it later, without an agent update.
Authorizations
A Recursion API key, created in the console under API keys.
Headers
Optional tenant consistency check. When present, it must name the tenant bound to the API key, including when x-organization-id is default.
1Organization in which to act. Required for a tenant-scoped API key. Optional for an organization-scoped key, where it must name that same organization. The value may be an organization id or default.
1Body
Request body for creating a skill group.
The group's addressable name, lowercase letters, digits, and single hyphens, e.g. document-ops. Held to the same shape as a skill name so the two never disagree in a listing that shows them together.
What this group collects, for operators browsing the catalog. Never disclosed to the model, so it does not need to read as a routing signal the way a skill's description does.
Human-readable title for listings. Defaults to the name.
Caller-owned key/value data stored with the group and returned unchanged.
Response
A folder of skills, for browsing a large catalog and for attaching a whole set to an agent in one entry. Attaching a group resolves to its members when a session starts, so adding a skill to the group reaches every agent already attached to it. Groups are never disclosed to the model.
A folder of skills, for browsing a large catalog and for attaching a whole set to an agent in one entry. Attaching a group resolves to its members when a session starts, so adding a skill to the group reaches every agent already attached to it. Groups are never disclosed to the model.
Server-assigned RFC 3339 timestamp of when the group was created.
The group's addressable name, lowercase with single hyphens, e.g. document-ops.
Organization that owns the group. Server-assigned from the caller's credentials; a value sent in a request body is ignored.
How many live skills are currently filed under this group. Derived on read.
-9007199254740991 <= x <= 9007199254740991Server-assigned id of the group, used in the skill-group routes and when attaching a whole group to an agent.
Server-assigned RFC 3339 timestamp of the most recent update to the group.
What this group collects, for operators browsing the catalog. Never disclosed to the model.
Human-readable title shown wherever groups are listed. Defaults to the name.
Caller-owned key/value data stored with the group and returned unchanged.