Work

Create Work Agent

Create one Work agent and its conversation.

visibility: "organization" needs the share permission (see GET /work/agents/policy); 403 otherwise. Creating does not run it.

post/work/agents

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/work/agents
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid nullable

Retry-safety key (a UUID). Replaying one returns the ORIGINAL agent instead of creating a second. Omit it and the server mints one, so a retried request creates again.

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

namestring required

Agent name

rolestring

Role shown beside the name

descriptionstring required

The agent's instructions

avatar'spark' | 'compass' | 'chart' | 'code' | 'pen' | 'search' | 'shield' | 'bolt'

Avatar glyph

visibility'private' | 'organization'

private to its owner, or shared with the organization

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.