Custom analysts

Custom analysts are models you define (name, base model, tone, emoji, optional description). Use your API key on each request—identity comes from the key, so you do not send a user object in the body.

Endpoints

Method	Path	Action
POST	/users/custom-analysts	Create
PUT	/users/custom-analysts/:analystId	Update
GET	/users/custom-analysts	List
DELETE	/users/custom-analysts/:analystId	Delete

Guides

Create — returns 201 Created on success.
Update
List
Delete

Organisation memory sync

Create and update requests can optionally sync analyst-specific organisation memory after the main analyst call succeeds. Successful responses may include an organisationMemorySync block. If the analyst is created or updated but the follow-up memory sync fails, the API can still return 502, so inspect the response carefully before retrying.

Use in run-models

After you create or list analysts, use the returned id with modelType: "custom-model" in the user object on Run models, or pass a customAnalyst object as described there.