Get a project by ID

GET

/projects/:project_id

Get a project with the given ID.

Path parameters

project_idstringRequired

Headers

Auth

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

Response

Successful Response

idstring

A unique ID assigned to this project.

created_atdatetime

Project created at

updated_atdatetime

Last time project was updated at

entity_idstring

The ID of the entity to which the project was issued.

namestring=1 character

The project name.

codestringOptionalformat: "^[a-zA-Z0-9]+$"=1 character

Project code

colorstringOptional

Project color

created_by_entity_user_idstringOptional

Project created by entity user

descriptionstringOptional

Description of project

end_datestringOptional

Project end date

parent_idstringOptional

Parent project ID

partner_metadatamap from strings to anyOptional

Project metadata

start_datestringOptional

Project start date

tagslist of objectsOptional

A list of user-defined tags (labels) assigned to this project.

Errors

GET

1 curl https://api.sandbox.monite.com/v1/projects/project_id \
2      -H "x-monite-version: 2024-01-31" \
3      -H "x-monite-entity-id: x-monite-entity-id" \
4      -H "Authorization: Bearer <token>"

1 {
2   "id": "id",
3   "created_at": "2024-01-15T09:30:00Z",
4   "updated_at": "2024-01-15T09:30:00Z",
5   "entity_id": "entity_id",
6   "name": "Marketing",
7   "code": "code",
8   "color": "color",
9   "created_by_entity_user_id": "created_by_entity_user_id",
10   "description": "description",
11   "end_date": "end_date",
12   "parent_id": "parent_id",
13   "partner_metadata": {
14     "key": "value"
15   },
16   "start_date": "start_date",
17   "tags": [
18     {
19       "id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
20       "created_at": "2022-09-07T16:35:18Z",
21       "updated_at": "2022-09-07T16:35:18Z",
22       "name": "Marketing",
23       "category": "document_type",
24       "created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
25       "description": "Tag for the Marketing Department"
26     }
27   ]
28 }

Delete a project

Up Next

1	curl https://api.sandbox.monite.com/v1/projects/project_id \
2	-H "x-monite-version: 2024-01-31" \
3	-H "x-monite-entity-id: x-monite-entity-id" \
4	-H "Authorization: Bearer <token>"

1	{
2	"id": "id",
3	"created_at": "2024-01-15T09:30:00Z",
4	"updated_at": "2024-01-15T09:30:00Z",
5	"entity_id": "entity_id",
6	"name": "Marketing",
7	"code": "code",
8	"color": "color",
9	"created_by_entity_user_id": "created_by_entity_user_id",
10	"description": "description",
11	"end_date": "end_date",
12	"parent_id": "parent_id",
13	"partner_metadata": {
14	"key": "value"
15	},
16	"start_date": "start_date",
17	"tags": [
18	{
19	"id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
20	"created_at": "2022-09-07T16:35:18Z",
21	"updated_at": "2022-09-07T16:35:18Z",
22	"name": "Marketing",
23	"category": "document_type",
24	"created_by_entity_user_id": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
25	"description": "Tag for the Marketing Department"
26	}
27	]
28	}