api:post appeals
Table of Contents
- 01. Record field format
- 02. Associated attributes
- 03. Nomenclature
- 04. Index
- 05. Show
- 06. Create
- 07. See also
The following includes the details of how to interface with the post appeal records through the API.
Record field format
| Name | Type | Details |
|---|---|---|
id | integer | >0 |
post_id | integer | >0 |
reason | string | |
status | enum | See Status table for list of acceptable values. |
creator_id | integer | >0 |
created_at | timestamp | |
updated_at | timestamp |
Status
| Value | Enum |
|---|---|
| 0 | pending |
| 1 | succeeded |
| 2 | rejected |
Associated attributes
| Name | Type | Number | Availability | Details |
|---|---|---|---|---|
creator | user | single | required | User that created the forum topic. |
post | post | single | required | Post that the appeal belongs to. |
Nomenclature
- Plural form: "post appeals"
- Used in the URL pathname
- Singular form: "post appeal"
- Used for write parameters (Help:API Write Requests)
- Versions: none
Index
| HTTP Method | GET or POST* |
| Base URL | /post_appeals.json |
| Type | read request |
| Description | The default order is ID descending. * Accepts POST under certain circumstances. See Help:API read requests. |
Search attributes
All of the following are standard attributes with all of their available formats and qualifiers.
- Number syntax
idpost_idcreated_atupdated_at- Text syntax
reason- Enum syntax
status- User syntax
creator- Post syntax
status
Special search parameters
reason_matches- Case-insensitive wildcard search on the reason field.
Search order
The search order can only be changed with the custom parameter.
Show
| HTTP Method | GET or POST* |
| Base URL | /post_appeals/$id.json |
| Type | read request |
| Description | $id is the post appeal ID.* Accepts POST under certain circumstances. See Help:API read requests. |
Create
| HTTP Method | POST |
| Base URL | /post_appeals.json |
| Type | write request |
| Description |
Create parameters
- Required:
post_idreason