TEtellers

Get Custom Agent By Slug

Resolve a published assistant's slug for a signed-in caller.

Declared above /{custom_agent_id} so "by_slug" is not mistaken for an assistant id.

Lands on the assistant itself when the caller can already see it — that is the row carrying the prompt, the publication links and the rights the client renders edit affordances from. Every other caller lands on the live copy, exactly what /preview/agent/custom/by_slug/{slug_id} serves them, and an unknown slug or an assistant with nothing live is a 404 either way.

get/agent/by_slug/{slug_id}

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

slug_idstring required

Headers

x-api-keystring nullable
authorizationstring nullable

Response

Successful Response

idstring required
namestring required
descriptionstring required
created_atstring date-time required
updated_atstring date-time required
last_editstring date-time nullable
logo_urlstring nullable required
logo_mime_typestring nullable
logo_status'PROCESSING' | 'READY' | 'OPTIMIZED' | 'FAILED'
demo_urlstring nullable
demo_mime_typestring nullable
is_public_readboolean
publication_status'ORIGINAL' | 'PENDING' | 'POSTED'

Where a ta_custom_agent row sits in the publication flow.

An assistant is ORIGINAL and stays editable for its whole life. Publishing freezes a copy of it as PENDING; approving that copy makes it POSTED and retires whichever copy was POSTED before. An assistant can therefore have a live copy and a copy under review at the same time — which is the point, since otherwise submitting an update would mean taking the live one down.

needs_changesboolean
slug_idstring nullable
created_from_custom_agent_idstring nullable
pending_custom_agent_idstring nullable
pending_needs_changesboolean nullable
pending_reviewer_commentstring nullable
posted_custom_agent_idstring nullable
labelsstring[]
likes_countinteger
dislikes_countinteger
my_voteboolean nullable
roleCustomAgentRole[]
is_ownerboolean nullable
author_emailstring nullable

Changes

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