Metadata

Adds a metadata category to the specified project.

post

Adds a metadata category to the specified project.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the project.

projectIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

optionIdentifierstring · uuidRequired

Responses

204

No Content

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

post

/projects/{projectIdentifier}/metadata/{objectIdentifier}/categories

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/metadata/{objectIdentifier}/categories HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "optionIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

No content

Retrieves a paginated list of metadata entries for the project.

get

Retrieves a paginated list of metadata entries for the project, optionally filtered and sorted.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

projectIdentifierstringRequired

Query parameters

pageNumberinteger · int32Optional

The page number to retrieve.

pageSizeinteger · int32Optional

The number of items per page.

searchTextstringOptional

Optional search text to filter metadata entries.

sortinginteger · enumOptional

The sorting option for the results.

Possible values:

descbooleanOptional

Whether to sort in descending order.

Default: true

Responses

200

OK

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

get

/projects/{projectIdentifier}/metadata

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/metadata HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "isYes": true,
    "text": "text",
    "decimalValue": 1,
    "date": "2026-01-28T11:11:54.652Z",
    "categories": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "singleCategoryIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "metadata": {
      "name": "text",
      "description": "text",
      "dataType": "text",
      "isRequired": true,
      "options": [
        {
          "name": "text",
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
    }
  }
]

Creates a new metadata entry for the project.

post

Creates a new metadata entry for the project.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

projectIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

isYesboolean · nullableOptional

decimalValuenumber · double · nullableOptional

textstring · nullableOptional

datestring · date-time · nullableOptional

singleCategoryIdentifierstring · uuid · nullableOptional

categoriesstring · uuid[] · nullableOptional

organizationMetadataIdentifierstring · uuidOptional

Responses

201

Created

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post

/projects/{projectIdentifier}/metadata

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/metadata HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 271

{
  "isYes": true,
  "decimalValue": 1,
  "text": "text",
  "date": "2026-01-28T11:11:54.652Z",
  "singleCategoryIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "categories": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "organizationMetadataIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

{
  "isYes": true,
  "text": "text",
  "decimalValue": 1,
  "date": "2026-01-28T11:11:54.652Z",
  "categories": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "singleCategoryIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "metadata": {
    "name": "text",
    "description": "text",
    "dataType": "text",
    "isRequired": true,
    "options": [
      {
        "name": "text",
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Retrieves a metadata entry by its object identifier.

get

Retrieves a metadata entry by its object identifier.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the metadata entry.

projectIdentifierstringRequired

Responses

200

OK

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

get

/projects/{projectIdentifier}/metadata/{objectIdentifier}

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/metadata/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "isYes": true,
  "text": "text",
  "decimalValue": 1,
  "date": "2026-01-28T11:11:54.652Z",
  "categories": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "singleCategoryIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "metadata": {
    "name": "text",
    "description": "text",
    "dataType": "text",
    "isRequired": true,
    "options": [
      {
        "name": "text",
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Updates a metadata entry for the project.

put

Updates a metadata entry for the project.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the metadata entry to update.

projectIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

isYesboolean · nullableOptional

decimalValuenumber · double · nullableOptional

textstring · nullableOptional

datestring · date-time · nullableOptional

organizationMetadataIdentifierstring · uuidOptional

singleCategoryIdentifierstring · uuid · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

put

/projects/{projectIdentifier}/metadata/{objectIdentifier}

HTTPcURLJavaScriptPython

PUT /projects/{projectIdentifier}/metadata/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 217

{
  "isYes": true,
  "decimalValue": 1,
  "text": "text",
  "date": "2026-01-28T11:11:54.652Z",
  "organizationMetadataIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "singleCategoryIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

{
  "isYes": true,
  "text": "text",
  "decimalValue": 1,
  "date": "2026-01-28T11:11:54.652Z",
  "categories": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "singleCategoryIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "metadata": {
    "name": "text",
    "description": "text",
    "dataType": "text",
    "isRequired": true,
    "options": [
      {
        "name": "text",
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Removes a metadata category from the specified project.

delete

Removes a metadata category from the specified project.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the project.

optionIdentifierstring · uuidRequired

The unique identifier of the category option to remove.

projectIdentifierstringRequired

Responses

204

No Content

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

delete

/projects/{projectIdentifier}/metadata/{objectIdentifier}/categories/{optionIdentifier}

HTTPcURLJavaScriptPython

DELETE /projects/{projectIdentifier}/metadata/{objectIdentifier}/categories/{optionIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content