Flag (global)

Represents a single flag configured in DreamApply. For a flag assigned to a specific application, see Flag.

URI
/api/v10/applications/flags/ID

Get a flag

Retrieve information about a specific flag configured in DreamApply.

Syntax
GET /api/v10/applications/flags/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Request
curl
curl \
  -X GET \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  "https://apply.example.edu/api/v10/applications/flags/1"

Header	Value	Description
`Content-Type`	`application/json`	The media type of the resource
`Content-Length`	`1234`	The size of the response body in bytes

Response code	Description
`200 OK`	The flag data was successfully returned
`404 Not Found`	The flag does not exist

Response
{
  "id": 1,
  "created": "2025-03-14T13:28:51+00:00",
  "name": "Awaiting interview"
}

Remove a flag from DreamApply and unassign it from all applications to which the flag is assigned.

Syntax
DELETE /api/v10/applications/flags/1
Host: apply.example.edu
Authorization: DREAM apikey="..."

Request
curl
curl \
  -X DELETE \
  -H "Authorization: DREAM apikey=\"YOUR-API-KEY\"" \
  "https://apply.example.edu/api/v10/applications/flags/1"

Header	Value	Description
`Content-Type`	`text/plain`	The media type of the resource
`Content-Length`	`0`	The size of the response body in bytes

Response code	Description
`204 No Content`	The flag was successfully deleted
`404 Not Found`	The flag was not found