Access

Set access

Choose who can wake an agent on a channel.

put/agents/{id}/access/{channel}

Request

  • Base URL
    https://app.artil.ai/api
  • URL
    https://app.artil.ai/api/agents/{id}/access/{channel}
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://mcp.artil.ai/oauth/authorize
      Token URL: https://mcp.artil.ai/oauth/token scopes: agent

Path parameters

idstring uuid required

The agent's id

channelstring required

Request body

admit'anyone' | 'team' | 'list' required
sendersstring[] required

Response

The channel's access

admit'anyone' | 'team' | 'list' required

Whether anyone, the workspace's members and agents besides the listed senders, or only the listed senders wake the agent; a new agent lists only its creator for email and its Message URL and starts with team for texts, and its Message URL is never open to anyone

sendersstring[] required

Email addresses, phone numbers, Telegram user ids and usernames, or for the Message URL the ids of agents and members

Changes

No recorded changes to this operation across all 1 revision of this API.