Skip to main content
GET
Get assistant specialization by identifier

Authorizations

Authorization
string
header
required

An API key from your Devic console, sent as Authorization: Bearer <key>. An embedded front end sends a tenant-session token instead, so no API key reaches the browser, and an OAuth integration sends its access token. Missing, invalid or expired credentials get a 401. See Authentication.

Path Parameters

identifier
string
required

Identifier of the assistant specialization to retrieve

Query Parameters

includePresets
boolean
default:false

Return the assistant's system prompt in presets. Omitted by default because this endpoint is also what an embedded widget calls to render itself. Custom assistants only, and refused with 403 to a tenant session.

Response

Assistant specialization details

identifier
string
required

Unique identifier for the assistant specialization

name
string
required

Human-readable name of the specialization

createdAt
string<date-time>
required

Timestamp when the specialization was created

description
string

Detailed description of what the specialization does

presets
string

The assistant's system prompt. Only present when the request asked for it with includePresets=true, and only for custom assistants. Read it before a partial update if you intend to edit the prompt rather than replace it: PATCH overwrites presets wholesale.