Sign in

v1

latestOpenAPI 3.1.02026-07-13305453.8 KB
Fields

Create field

Create a custom field definition. Requires a private API key.

post/v1/fields

Request body

keystring required
namestring required
descriptionstring
type'text' | 'number' | 'boolean' | 'date' | 'richtext' | 'select' | 'multiselect' required
requiredboolean

Example request

{
  "key": "audience",
  "name": "Audience",
  "description": "Who this post is for",
  "options": [
    {
      "value": "developers",
      "label": "Developers"
    },
    {
      "value": "founders",
      "label": "Founders"
    }
  ]
}

Response

Field created successfully

Example response

{
  "field": {
    "id": "cryitfjp7890yz12abcdefg",
    "key": "audience",
    "name": "Audience",
    "description": "Who this post is for",
    "options": [
      {
        "id": "cryitfjp9012ab34cdefghij",
        "value": "developers",
        "label": "Developers",
        "createdAt": "2024-01-15T10:00:00Z",
        "updatedAt": "2024-01-16T12:00:00Z"
      }
    ],
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-16T12:00:00Z"
  }
}