TypeScript SDK: Muting agent mic programmatically returns 403

General Discussion
1

Trying to mute the local agent microphone via the JavaScript SDK during an active conversation. I have the conversationId and participantId. Calling conversationsApi.postConversationsParticipantMute with the standard payload returns a 403 Forbidden.

await client.conversationsApi.postConversationsParticipantMute(conversationId, participantId, {
 muted: true
});

The token has conversation:agent:write scope. The participant is the caller, not the agent. The API docs say this endpoint controls the participant’s audio state. Is there a separate endpoint for the local client state, or am I hitting a permission boundary on the participant resource? The error response is just {"code": "forbidden", "message": "Forbidden"}.

2

The docs state: “Mutating participant state requires the conversation:participant:write scope.” You’re using conversation:agent:write, which controls agent stats, not media. Swap the scope in your OAuth config. It’s a strict permission boundary.