Endpoints
characters/{id}
Was this page helpful?
Read or soft-delete one reusable character owned by the authenticated account.
GET
/api/v1/characters/{id}
Get one saved character
Authentication: Bearer API key required
curl "https://reviral.ai/api/v1/characters/$JOB_ID" \
-H "Authorization: Bearer $REVIRAL_API_KEY"Responses
- 200
- Owned active character
- 401
- Key is missing, revoked, or invalid
- 404
- Character not found
- 500
- Character lookup unavailable
DELETE
/api/v1/characters/{id}
Soft-delete a saved character
Authentication: Bearer API key required
curl -X DELETE "https://reviral.ai/api/v1/characters/$JOB_ID" \
-H "Authorization: Bearer $REVIRAL_API_KEY"Responses
- 200
- Character deleted
- 400
- Invalid character ID
- 401
- Key is missing, revoked, or invalid
- 500
- Character delete unavailable