Skip to content
EventPoint Developer Documentation

Create or update metadata field

POST
/api/projects/{projectid}/meta-fields
curl --request POST \
  --url https://api.eventpoint.io/api/projects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/meta-fields \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "created": "2026-04-15T12:00:00Z", "modified": "2026-04-15T12:00:00Z", "etag": "example", "projectId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "metaNum": 1, "col": "example", "code": "example", "name": "example", "description": "example", "isRequired": true, "publish": true, "itemOrder": 1, "valueKind": "Text", "maxValue": 1, "minValue": 1, "maxLength": 1, "minLength": 1, "optionsText": "example", "defaultValue": "example", "minSelections": 1, "maxSelections": 1, "isCategory": true, "categoryId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "isLocked": true }'

For fields with options, provide pipe-delimited or line-separated option text.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
projectid
required
string format: uuid

The project identifier.

Query Parameters

Section titled “Query Parameters”
metafieldid
string format: uuid

The optional metadata field identifier.

Request Bodyrequired

Section titled “Request Bodyrequired”

The metadata field.

object
id
string format: uuid
created
string format: date-time
modified
string format: date-time
etag
null | string
projectId
string format: uuid
metaNum
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
col
null | string
code
null | string
name
null | string
description
null | string
isRequired
boolean
publish
boolean
itemOrder
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
valueKind
Allowed values: Text LongText TrueFalse YesNo Number Decimal Select Date Time DateTime MultiSelect Url Email
maxValue
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
minValue
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
maxLength
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
minLength
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
optionsText
null | string
defaultValue
null | string
minSelections
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
maxSelections
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
isCategory
boolean
categoryId
null | string format: uuid
isLocked
boolean

Responses

Section titled “Responses”

200

Section titled “200”

OK

object
data
object
id
string format: uuid
created
string format: date-time
modified
string format: date-time
etag
null | string
projectId
string format: uuid
metaNum
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
col
null | string
code
null | string
name
null | string
description
null | string
isRequired
boolean
publish
boolean
itemOrder
integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
valueKind
Allowed values: Text LongText TrueFalse YesNo Number Decimal Select Date Time DateTime MultiSelect Url Email
maxValue
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
minValue
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
maxLength
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
minLength
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
optionsText
null | string
defaultValue
null | string
minSelections
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
maxSelections
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
isCategory
boolean
categoryId
null | string format: uuid
isLocked
boolean
message
null | string
success
boolean
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/

403

Section titled “403”

Forbidden

object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string