> For the complete documentation index, see [llms.txt](https://docs.epic-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.epic-ai.com/api-dokumentation/inbox-answers.md).

# Inbox Answers

## Lists all response snippets

> \
> \
> \*\*Required Permission:\*\* \`chatbots.inbox.answers.list\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Inbox answers","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/inbox/{chatbotId}/answers":{"get":{"operationId":"InboxAnswerController_listAnswers[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The ID of the chatbot.","schema":{"type":"string"}}],"responses":{"200":{"description":"List of all response snippets.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAnswersResponseDto"}}}},"403":{"description":"Insufficient permissions."}},"summary":"Lists all response snippets","tags":["Inbox answers"],"description":"\n\n**Required Permission:** `chatbots.inbox.answers.list`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"ListAnswersResponseDto":{"type":"object","properties":{"answers":{"description":"The list of answers.","type":"array","items":{"$ref":"#/components/schemas/AnswerDto"}},"error":{"type":"string","description":"Optional error message."}},"required":["answers"]},"AnswerDto":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the answer."},"created":{"type":"string","description":"Timestamp when the answer was created."},"updated":{"type":"string","description":"Timestamp when the answer was last updated."},"name":{"type":"string","description":"The name/title of the text snippet."},"message":{"type":"string","description":"The content of the text snippet."}},"required":["id","created","updated","name","message"]}}}}
```

## Creates a new response snippet

> \
> \
> \*\*Required Permission:\*\* \`chatbots.inbox.answers.create\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Inbox answers","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/inbox/{chatbotId}/answers":{"post":{"operationId":"InboxAnswerController_createAnswer[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The ID of the chatbot.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAnswerRequestDto"}}}},"responses":{"201":{"description":"Response snippet created successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerResponseDto"}}}},"400":{"description":"Invalid input data."},"403":{"description":"Insufficient permissions."}},"summary":"Creates a new response snippet","tags":["Inbox answers"],"description":"\n\n**Required Permission:** `chatbots.inbox.answers.create`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"CreateAnswerRequestDto":{"type":"object","properties":{"name":{"type":"string","description":"The name/title of the text snippet."},"message":{"type":"string","description":"The content of the text snippet."}},"required":["name","message"]},"AnswerResponseDto":{"type":"object","properties":{"answer":{"description":"The answer.","nullable":true,"allOf":[{"$ref":"#/components/schemas/AnswerDto"}]},"error":{"type":"string","description":"Optional error message."}},"required":["answer"]},"AnswerDto":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the answer."},"created":{"type":"string","description":"Timestamp when the answer was created."},"updated":{"type":"string","description":"Timestamp when the answer was last updated."},"name":{"type":"string","description":"The name/title of the text snippet."},"message":{"type":"string","description":"The content of the text snippet."}},"required":["id","created","updated","name","message"]}}}}
```

## Updates an existing response snippet

> \
> \
> \*\*Required Permission:\*\* \`chatbots.inbox.answers.edit\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Inbox answers","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/inbox/{chatbotId}/answers/{answerId}":{"put":{"operationId":"InboxAnswerController_updateAnswer[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The ID of the chatbot.","schema":{"type":"string"}},{"name":"answerId","required":true,"in":"path","description":"The ID of the response snippet to update.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAnswerRequestDto"}}}},"responses":{"200":{"description":"Response snippet updated successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerResponseDto"}}}},"400":{"description":"Invalid input data."},"403":{"description":"Insufficient permissions."}},"summary":"Updates an existing response snippet","tags":["Inbox answers"],"description":"\n\n**Required Permission:** `chatbots.inbox.answers.edit`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"UpdateAnswerRequestDto":{"type":"object","properties":{"name":{"type":"string","description":"The new name of the text snippet."},"message":{"type":"string","description":"The new content of the text snippet."}},"required":["name","message"]},"AnswerResponseDto":{"type":"object","properties":{"answer":{"description":"The answer.","nullable":true,"allOf":[{"$ref":"#/components/schemas/AnswerDto"}]},"error":{"type":"string","description":"Optional error message."}},"required":["answer"]},"AnswerDto":{"type":"object","properties":{"id":{"type":"string","description":"The unique identifier of the answer."},"created":{"type":"string","description":"Timestamp when the answer was created."},"updated":{"type":"string","description":"Timestamp when the answer was last updated."},"name":{"type":"string","description":"The name/title of the text snippet."},"message":{"type":"string","description":"The content of the text snippet."}},"required":["id","created","updated","name","message"]}}}}
```

## Deletes a response snippet

> \
> \
> \*\*Required Permission:\*\* \`chatbots.inbox.answers.delete\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Inbox answers","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/inbox/{chatbotId}/answers/{answerId}":{"delete":{"operationId":"InboxAnswerController_deleteAnswer[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The ID of the chatbot.","schema":{"type":"string"}},{"name":"answerId","required":true,"in":"path","description":"The ID of the response snippet to delete.","schema":{"type":"string"}}],"responses":{"200":{"description":"Response snippet deleted successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAnswerResponseDto"}}}},"403":{"description":"Insufficient permissions."}},"summary":"Deletes a response snippet","tags":["Inbox answers"],"description":"\n\n**Required Permission:** `chatbots.inbox.answers.delete`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"DeleteAnswerResponseDto":{"type":"object","properties":{"error":{"type":"string","description":"Optional error message."}}}}}}
```