Add Custom Agent Share

Share the assistant with a group or with one person by email.

Needs can_share on the assistant: its author, an ADMIN grant, or a grant with can_share. Below ADMIN the caller grants at most their own right, never can_share, and cannot change a grant they could not have made. An email with no account yet is listed in pending_invites until someone signs in with it. Returns the sharing as GET /{custom_agent_id}/share does.

post/agent/{custom_agent_id}/share/add

Request

Base URL
https://api.tellers.ai (the document declares no server; this is the origin it was published from)
Auth
none declared

Path parameters

custom_agent_idstring uuid required

Headers

x-api-keystring nullable

authorizationstring nullable

Request body

group_idstring uuid nullable

emailstring nullable

right'ADMIN' | 'READ' | 'WRITE' | 'VIEW'

A right on an asset, a chat or an assistant, weakest first: VIEW < READ < WRITE < ADMIN.

On an asset, VIEW sees the file and everything about it except its comments, which READ adds. Chats and assistants have nothing READ adds, so VIEW opens what READ does there. Group memberships start at READ.

can_shareboolean

Lets the grantee share the assistant onward and make it public, below ADMIN. Publishing still takes ADMIN. Only an ADMIN can grant it. An existing grant is set to this value.

Response

Successful Response

is_public_readboolean