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
id
post_id
created_at
updated_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_id
reason