/people/{person_id}/conversation/Changes CRM data and records actor/origin attribution. Does not send a message or change conversation access. Read current details before replacing collections; retain the same request key only for an identical retry.
- Required permissions
people:write- Available scopes
- Entire Portal or Selected source channels
Headers and URL parameters
| Name | Location | Type | Required |
|---|---|---|---|
person_idCopy the pers_ slug from a Person response id; never use a name or database ID.View parameter schema | path | string | Yes |
Idempotency-KeyView parameter schema | header | string | Yes |
If-MatchCopy the ETag from the latest Person detail read.View parameter schema | header | string | Yes |
Request body
application/json · Required body
| Field | Type | Required |
|---|---|---|
conversation_id | string | Yes |
View request schema
Example request
curl --request POST \
--url "https://api.levr.ai/v1/people/$PERSON_ID/conversation/" \
--header "Authorization: Bearer $LEVR_API_KEY" \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--header "If-Match: $IF_MATCH" \
--header "Content-Type: application/json" \
--data "@request.json"curl --request POST \
--url "https://api.levr.ai/v1/people/$PERSON_ID/conversation/" \
--header "Authorization: Bearer $LEVR_API_KEY" \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--header "If-Match: $IF_MATCH" \
--header "Content-Type: application/json" \
--data '{
"conversation_id": "chat_7k2m9q4v6x8n3p5r"
}'Responses
| Status | What it means |
|---|---|
200 | Successful response. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
400 | Correct the request fields and try again. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
401 | Provide a valid API key and try again. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
403 | This API key does not allow the requested action. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
404 | The requested resource was not found or is not available to this API key. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
409 | The request conflicts with the resource's current state. Refresh it before trying again. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
412 | The request was not completed. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
429 | Too many requests were sent. Wait before trying again. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
500 | Levr could not complete the request. Keep the request ID and retry when safe. View response headers
View response schemaIllustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response |
