Skip to main content
POST
Create attribute
Creates an Attribute: an outbound API call that runs automatically at the start of a conversation to load context (for example, a GetUserInfo lookup). Send alwaysGet: true; omitting it creates an Action instead.
This route creates the record only. Add the input and output schema with Update attribute, then add its HTTP calls with Create data step. An attribute only runs for agents it is assigned to; see Assign to agents.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
string
required
application/json

Body parameters

string
required
Display name.
string
Optional human-readable description.
boolean
required
Send true to create an attribute. false (the default) creates a rule-invoked action instead.
string
Optional source. Current values include ui, api, widget, and integration providers such as zendesk and intercom.

Response

Returns the created Action / Attribute. inputSchema and outputSchema start empty.

Errors

The body is malformed or source uses an unsupported value.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.
Fini failed while creating the record in storage.