Account, keys and webhooks ›
Set heard
PUT
/v1/me/heardSet heard.
Requestcurl
- curl -X PUT https://agental.io/v1/me/heard \
- -H "Authorization: Bearer $AGENTAL_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{"heard":"…"}'
Answer200 OK · Heard
- {
- "heard": string | null,
- }
The answer as it is kept.
Headers
AuthorizationrequiredBearer key | An API key that may make this call. |
Body
heardrequiredstring | A few words, kept as one line of at most 200 characters. It replaces an earlier answer. |
Returns
200 The answer as it is kept.
Heard1 field
heardstringnull
What the person wrote to "How did you hear about agental?".
More
Null until they answer.Errors and other answers
| 400 | heard_empty the answer says nothing. Nothing was kept. |
| 403 | session_required an API key cannot do this. A person signed in can, in the console. |
Every error answers { "error": { "code", "message" } }; a key without the action a call needs answers 403 key_action_forbidden, naming it.