Skip to content

Commit 9c8d88e

Browse files
authored
Document forbidden response on private status translation attempt (#1790)
1 parent a4f9606 commit 9c8d88e

File tree

1 file changed

+12
-2
lines changed

1 file changed

+12
-2
lines changed

content/en/methods/statuses.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -658,7 +658,7 @@ Status is private or does not exist
658658
POST /api/v1/statuses/:id/translate HTTP/1.1
659659
```
660660

661-
Translate the status content into some language.
661+
Translate the status content into some language. Only statuses with Public and Unlisted visibility can be translated.
662662

663663
**Returns:** [Translation]({{< relref "entities/translation" >}})\
664664
**OAuth:** App token + `read:statuses`\
@@ -730,14 +730,24 @@ Translating a status with poll into English
730730

731731
##### 404: Not found
732732

733-
Status is private or does not exist
733+
Status does not exist
734734

735735
```json
736736
{
737737
"error": "Record not found"
738738
}
739739
```
740740

741+
##### 403: Forbidden
742+
743+
Status is private or direct
744+
745+
```json
746+
{
747+
"error": "This action is not allowed"
748+
}
749+
```
750+
741751
##### 503: Service unavailable
742752

743753
The translation request failed

0 commit comments

Comments
 (0)