Intervals API Resource:

projectlabel

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

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 project labels starting from the nth project label.
limit	no	integer	10	Sets a limit to the amount of project labels 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 /projectlabel/

To filter the list based on certain parameters:

GET /projectlabel/?offset={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 (55)
color	yes	string		Should be a 6 character hex value.
priority	yes	integer		A relative integer value. Higher value represents higher priority.
active	yes	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 project label
name	no	Label name
color	no	Label color as stored for display (typically 6 hex digits without a leading `#`, e.g. 44bb44)
priority	no	Sort order when listing labels (lower values first; often a string in JSON)
active	no	Whether the label is active ("t") or inactive ("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",
    "active": "t"
}

When retrieving a collection (GET /projectlabel/), the response envelope includes: personid (authenticated user's ID), status ("OK"), code (200), listcount (total matching records before limit/offset), and projectlabel (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 /projectlabel/{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