Create a project metadata
POST/api/project-metadata
Required permissions:
- settings.company: allows to create resources.
Here the dedicated support page.
Request
Header Parameters
The company you want to interact with
The API version you want to use
- application/json
Body
Metadata tag name
Values of the metadata tag
Is metadata tag required
Responses
- 201
- 400
- 401
- 403
- 412
Returns the project metadata created.
- application/json
- Schema
- Example (from schema)
Schema
Possible values: >= 1
The unique identifier of the resource
The date and time when the resource was created
The date and time when the resource was last updated
{
  "id": 1,
  "created_at": "2025-10-28T10:23:49.714Z",
  "updated_at": "2025-10-28T10:23:49.714Z",
  "key": "Sector",
  "values": [
    "IT",
    "Finance"
  ],
  "is_required": true
}
Validation failed
- application/json
- Schema
- Example (from schema)
Schema
- Array [ 
- ] 
Error unique key
Human-readable message describing the error
failures
object[]
List of validation errors
Name of the field causing the error
Human-readable description of the error
{
  "key": "invalid_data",
  "message": "You provided invalid data. Check 'failures' for details.",
  "failures": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "string",
  "message": "string"
}
Forbidden
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "string",
  "message": "string"
}
Precondition failed
- application/json
- Schema
- Example (from schema)
Schema
Error unique key
Human-readable message describing the error
{
  "key": "precondition_failure",
  "message": "string"
}