Projects API

Project metadata — categories, priorities, statuses, tags, and types.

ProjectCategories

ProjectCategories collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectCategories. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-categories?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectCategory record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-categories \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectCategory created successfully"
}

ProjectPriorities

ProjectPriorities collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectPriorities. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-priorities?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectPriority record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-priorities \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectPriority created successfully"
}

ProjectStatuses

ProjectStatuses collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectStatuses. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-statuses?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectStatus record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-statuses \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectStatus created successfully"
}

ProjectTags

ProjectTags collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectTags. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-tags?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectTag record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-tags \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectTag created successfully"
}

ProjectTypes

ProjectTypes collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectTypes. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-types?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectType record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-types \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectType created successfully"
}

Projects API

Project metadata — categories, priorities, statuses, tags, and types.

ProjectCategories

ProjectCategories collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectCategories. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-categories?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectCategory record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-categories \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectCategory created successfully"
}

ProjectPriorities

ProjectPriorities collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectPriorities. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-priorities?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectPriority record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-priorities \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectPriority created successfully"
}

ProjectStatuses

ProjectStatuses collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectStatuses. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-statuses?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectStatus record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-statuses \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectStatus created successfully"
}

ProjectTags

ProjectTags collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectTags. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-tags?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectTag record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-tags \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectTag created successfully"
}

ProjectTypes

ProjectTypes collection — standard CRUD operations. Filter with where[], paginate with page/limit, control depth for relations.

Returns a paginated list of ProjectTypes. Supports filtering, sorting, and relationship depth.

Auth: Both

Query Parameters

Name	Type	Required	Description
page	number	optional	Page number (default: 1)
limit	number	optional	Results per page (default: 20, max: 100)
sort	string	optional	Sort field, prefix with - for desc (e.g. -createdAt)
where	object	optional	Filter object e.g. where[status][equals]=active
depth	number	optional	Relationship depth (default: 1)

Example Request

curl https://v2-api.amdital.com/api/project-types?limit=20&sort=-createdAt \
  -H "Authorization: Bearer <token>"

Example Response

{
  "docs": [
    {
      "id": "64a1b2c3d4e5f6789abc0001",
      "createdAt": "2026-01-15T10:00:00Z",
      "updatedAt": "2026-01-15T10:00:00Z"
    }
  ],
  "totalDocs": 42,
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "hasNextPage": true,
  "hasPrevPage": false
}

Creates a new ProjectType record. Requires authenticated workspace context.

Auth: Both

Body / Path Parameters

Name	Type	Required	Description
workspace	string	required	Workspace ID (from JWT claims)

Example Request

curl -X POST https://v2-api.amdital.com/api/project-types \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"workspace":"ws_abc123"}'

Example Response

{
  "doc": {
    "id": "64a1b2c3d4e5f6789abc0001",
    "createdAt": "2026-01-15T10:00:00Z",
    "updatedAt": "2026-01-15T10:00:00Z"
  },
  "message": "ProjectType created successfully"
}