Intervals API Resource:

taskpriority

The base URL for this resource is located at
https://api.myintervals.com/taskpriority/

Collection

Allowed HTTP Methods
Method	Group Access
GET	Administrator, Manager, Resource, Executive

Allowed Filters
Filter Name	Required?	Expects	Default	Description
active	no	boolean
offset	no	integer		Return taskpriorities starting from the nth taskpriority.
limit	no	integer	10	Sets a limit to the amount of taskpriorities returned in the response.

¹ Indicates that multiple values are allowed, in CSV format (e.g. "3,5,11,19").
² This field accepts HTML, but certain HTML elements may be stripped out.

Examples

To retrieve the entire list of this resource:

GET /taskpriority/

To filter the list based on certain parameters:

GET /taskpriority/?limit={value}

Note: You can string together multiple filters.

Member

Allowed HTTP Methods
Method	Group Access
GET	Administrator, Manager, Resource, Executive

Settable Fields for PUT and POST Requests
Field Name	Required?	Expects	Default	Description
name	yes	string (255)
color	yes	string		Should be a 6 character hex value.
priority	yes	integer		A relative integer value. Higher value represents higher priority.
isdefault	no	boolean
active	no	boolean

string (xxx) indicates a string with a maximum length of xxx characters.

Response Fields

The fields below are returned in GET responses. Boolean values are "t" / "f" strings. Numeric IDs and floats are returned as strings. Nullable fields may be JSON null.

Response Fields
Field Name	Nullable	Description
id	no	Unique identifier for the task priority row
name	no	Priority label (e.g. P1, P3, PLG)
color	no	Display color as 6 hex digits without `#`
priority	no	Sort order when listing priorities (lower first; string in JSON, e.g. `"1"` … `"5"`)
isdefault	no	Whether this is the account default priority for new tasks ("t"/"f")
active	no	Whether this priority is in use ("t") or retired ("f")

Sample response object. Non-null values are strings in JSON (including IDs, numeric fields, and booleans as "t" / "f"). Nullable fields may be JSON null when absent.

{
    "id": "123456",
    "name": "Example Name",
    "color": "FFDD00",
    "priority": "3",
    "isdefault": "t",
    "active": "t"
}

When retrieving a collection (GET /taskpriority/), the response envelope includes: personid (authenticated user's ID), status ("OK"), code (200), listcount (total matching records before limit/offset), and taskpriority (array of result objects). Defaults, no cap on limit, and how to paginate using listcount are described in the API Introduction (Pagination).

Examples

To retrieve one member resource:

GET /taskpriority/{id}/

Assuming no errors, the server will respond with 200 OK and the object requested.

Documentation

Resources

API Support

Looking for help?
Contact our support team.

OpenAPI

OpenAPI JSON spec (public)

Swagger UI on SwaggerHub

Start tracking time today

Connect Intervals to the tools and workflows your team already uses.

Try Intervals free