This is an old revision of the document!
/api/applications/flags
HEAD, GET
Get a list of all flags currently in the system.
Syntax
GET /api/applications/flags Host: apply.example.edu Authorization: DREAM apikey="..."
Response headers
Content-Type: application/json Content-Length: 1234
POST
Add a new flag using any text (up to 32 characters) as the flag's name. The URI for the flag created is returned in the Location header.
If a flag with this name exists already, a 409 Conflict will be returned, along with the URI of the offending flag in the Location header.
This method simply creates a new flag, but does not assign it to any applications. You are expected to use the PUT verb to add exiting flags to applications, see /api/applications/123/flags/1.
Syntax
POST /api/applications/flags Host: apply.example.edu Authorization: DREAM apikey="..."
Parameters
name | Required | This text will be displayed on the flag. Up to 32 characters. |
Response headers
Content-Type: application/json Content-Length: 0 Location: /api/applications/flags/456
Response codes
201 Created | New flag was created (and set) |
209 Conflict | Such a flag already exists |