Retrieve an automation level
Aufruf, Parameter, Antwort und Fehler von GET /v1/automations/{id}.
Zuletzt aktualisiert:
Returns the level of one kind of action, for example reply. An id that names no kind is a 404. A level cannot be changed through the API: a person of the management sets it in the app. Needs read access to inquiries.
Braucht den Scope read.
Aufruf
GET https://api.athaus.ai/v1/automations/{id}Parameter
Pfad
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | ja | The kind of action, for example reply. An unknown word is a 404. |
Kopf
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
Athaus-Version | string | nein | Optional and carries nothing a client needs: the version is the path. Accepted when it says v1 or 1. Any other value is a 400 api_version_unsupported. |
Beispiel
curl "https://api.athaus.ai/v1/automations/0190f3a2-7c1e-7b0e-9a41-5d2f6e8c3b17" \
-H "Authorization: Bearer ath_live_..."Antwort
Bei Erfolg kommt 200 mit Automation.
Automation
| Feld | Typ | Beschreibung |
|---|---|---|
object | string | Immer automation. |
id | string | The kind of action, in the same words as the kind of the MCP tool update_automation. The list is open: new kinds arrive. Eine von 24 Angaben der Liste im Standard. |
level | string | off: Athaus prepares nothing. ask: Athaus prepares it and waits for a yes. auto: Athaus does it without a yes. Eines von off, ask, auto. |
allowedLevels | string[] | The levels this kind may have. A kind that reaches people never allows auto for some actions. Eines von off, ask, auto. |
isDefault | boolean | true while nobody in the office has set the level; the default applies. |
goesOut | boolean | true if the action reaches a person outside the office. |
livemode | boolean | false for the test office of a test key. |
updatedAt | string (date-time) | null | When the level was last set. Null while it is the default. |
Köpfe der Antwort
| Kopf | Beschreibung |
|---|---|
Request-Id | Identifies this request. Quote it in a support request. |
Athaus-Version | The API version of this response: v1. |
Athaus-Release | The release of v1 that answered, for example 1.0. A label for support and changelogs; no request can select it. |
RateLimit-Policy | The quota policy of the bucket that applies. |
RateLimit | Remaining quota and seconds until the bucket is full again. |
Fehler
Jeder Fehler kommt als Problem Details. Verzweige auf code, nicht auf title oder detail.
| Status | Codes | Bedeutung |
|---|---|---|
400 | invalid_id, api_version_unsupported | Invalid request. |
401 | unauthorized | Missing or invalid API key. |
403 | insufficient_permissions, plan_required | The key lacks a right, or the plan does not include API access. |
404 | not_found | Nothing under this ID. |
429 | rate_limited | Rate limit exceeded. |
500 | internal_error | Server error. |
Weiter lesen
REST-API: Anmeldung mit einem API-Key
Jeder Aufruf von /v1 trägt einen API-Key als Bearer-Token. Wo du ihn bekommst, welche Scopes er trägt und was nicht geht.
REST-API: Fehler als Problem Details
Jeder Fehler von /v1 ist ein Problem nach RFC 9457 mit echtem HTTP-Status, einem Code zum Verzweigen und einer Request-Id für den Support.