Create a Field
POSThttps://euwest.api.elasticpath.com/v2/fields
- For Commerce, this endpoint creates a field.
- For Product Experience Manager, this endpoint creates an attribute.
Request
- application/json
Body
required
data object
Responses
- 201
- 422
- 500
Created
- application/json
- Schema
- Example (from schema)
- default
Schema
data object
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "string",
"field_type": "string",
"slug": "string",
"name": "string",
"description": "string",
"required": true,
"enabled": true,
"omit_null": true,
"validation_rules": [
{
"type": "enum",
"options": [
null
],
"to": "customer"
}
],
"meta": {
"owner": "enum",
"timestamps": {
"created_at": "2023-10-11T13:02:25.293Z",
"updated_at": "2023-10-11T13:02:25.293Z"
}
},
"links": {
"self": "https://euwest.api.elasticpath.com/v2/flows/3cf3ad3f-b12c-4a08-a6ab-05e6aab0122c/fields/c1c788d1-f1c7-4b90-938f-f158f3353c66"
},
"relationships": {
"flow": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "flow"
}
}
}
}
}
{
"data": {
"type": "field",
"name": "Product Rating",
"slug": "product-rating",
"field_type": "integer",
"validation_rules": [
{
"type": "between",
"options": {
"from": 1,
"to": 5
}
}
],
"description": "Average rating as given by our users",
"required": false,
"default": 0,
"enabled": true,
"order": 1,
"omit_null": false,
"relationships": {
"flow": {
"data": {
"type": "flow",
"id": "e4145c27-aba1-46af-81a3-58f5e1cf7f15"
}
}
}
}
}
Bad request. The request failed validation.
- application/json
- Schema
- Example (from schema)
- missing-name
Schema
errors Error[]required
{
"errors": [
{
"status": 500,
"title": "Internal server error",
"detail": "An internal error has occurred.",
"request_id": "00000000-0000-0000-0000-000000000000",
"meta": {
"missing_ids": [
"e7d50bd5-1833-43c0-9848-f9d325b08be8"
]
}
}
]
}
{
"errors": [
{
"title": "Validation Error",
"status": 400,
"detail": "data.attributes.name: \"name\" is required"
}
]
}
Internal server error. There was a system failure in the platform.
- application/json
- Schema
- Example (from schema)
- internal-server-error
Schema
errors Error[]required
{
"errors": [
{
"status": 500,
"title": "Internal server error",
"detail": "An internal error has occurred.",
"request_id": "00000000-0000-0000-0000-000000000000",
"meta": {
"missing_ids": [
"e7d50bd5-1833-43c0-9848-f9d325b08be8"
]
}
}
]
}
{
"errors": [
{
"status": 500,
"title": "Internal Server Error",
"detail": "There was an internal server error, you can report with your request id.",
"request_id": "635da56d-75a1-43cd-b696-7ab119756b3a"
}
]
}
Authorization: http
name: bearerAuthtype: httpscheme: bearer
- curl
- python
- go
- nodejs
- ruby
- csharp
- php
- java
- powershell
- CURL
curl -L -X POST 'https://euwest.api.elasticpath.com/v2/fields' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"data": {
"default": 0,
"description": "string",
"enabled": true,
"field_type": "string",
"name": "string",
"order": 0,
"relationships": {
"flow": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "flow"
}
}
},
"required": true,
"slug": "string",
"type": "string",
"validation_rules": [
{
"type": "enum",
"options": [
"string"
],
"to": "customer"
}
]
}
}'
ResponseClear