Projects

List project types

Returns the project type catalog of the account.

GET
/api/v1/project-types

Request examples

curl https://app.filmo.io/api/v1/project-types \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": [
    {
      "id": "project_type_9f3a2b",
      "name": "Example project type",
      "color": "Example color",
      "description": "Example text.",
      "createdAt": "2026-09-01T08:00:00.000Z",
      "updatedAt": "2026-09-01T08:00:00.000Z"
    }
  ]
}

Generated from the schema

Use it to resolve the projectTypeId filter of /api/v1/projects without guessing identifiers. It shares scope with projects, just as task-types does with tasks.

Authorizations

Bearer API key with the scope below. projects:read

Response

application/json

Successful response.

Response schema: ProjectTypeDto

Envelope: ProjectTypeItems. meta.warnings is present only when the operation is deprecated.

Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset

dataobject[]

Show child attributes
data.idstring

Unique identifier of the project type.

data.namestring

Project type name.

data.colorstring

Associated color, in hexadecimal, as rendered in the interface.

data.descriptionstring | null

Type description; null if it has none.

data.createdAtstring<date-time>

Creation date in ISO 8601 UTC.

data.updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

metaobject

Additional information about the response.

Show child attributes
meta.warningsobject[]

Lifecycle warnings; present only when the operation is deprecated.

Show child attributes
meta.warnings.codestring

Stable warning code.

Available options: deprecated

meta.warnings.messagestring

For people: what is deprecated, until when, and what to use.

meta.warnings.sunsetstring

Day (YYYY-MM-DD) the operation stops being served.

meta.warnings.replacementstring | null

operationId of the operation to use instead, or null if there is none.

Errors

StatusCodesMeaning
400validation_errorMalformed query or body. errors[] lists every offending field with its stable code.

401, 403, 429, 500 can be returned by any operation. Errors

Deprecation

This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy