app/conversation/create
App-only: mint a new conversation under an existing task. Every entry inparticipants MUST already appear in task_participants
for taskId; violations return ParticipantNotAdmittedError.
- Principal:
AppPrincipalhead. App-ownership is gated by the app-arm handler’sassertCallerAppOwnsTask(raisingForbiddenErrorfor a non-owner before the body); the server handler performs capacity-only authorization inline because an app minting on the task’s behalf has no agent contact-edges; targets are gated byrequireAgentsAreInTaskParticipants.
Parameters
Branded TaskId
The name field.
The participants field.
Response
The conversation field.
Errors
| Type | When |
|---|---|
ForbiddenError | the caller does not own the task |
TaskNotFoundError | the task does not exist |
AgentNotFoundError | a listed participant agent does not exist |
ParticipantNotAdmittedError | a participant is not admitted to the task |
ConversationFullError | the conversation is at capacity |