Create attribute
Attributes
Create attribute
Create an always-on attribute.
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/jsonBody 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 createdAction / Attribute. inputSchema and outputSchema start empty.
Errors
400 Bad Request
400 Bad Request
The body is malformed or
source uses an unsupported value.403 Forbidden
403 Forbidden
The API key does not include the
write scope required for this route.500 Internal Server Error
500 Internal Server Error
Fini failed while creating the record in storage.

