Create a Custom API Entry using the settings endpoint

POST 
https://useast.api.elasticpath.com/v2/settings/extensions/custom-apis/:custom_api_id/entries

Create a Custom API Entry using the settings endpoint

Request

Path Parameters

custom_api_id stringrequired
The id of the Custom API.
Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

application/json

Body

data CustomApiEntryAttributesrequired
typestring
Specifies the type of the resource object, use the api_type of the Custom API for Custom API Entry.
property name*any

Responses

201

Created

Response Headers

ETag

A unique identifier representing the current version of the resource. When the resource changes, the ETag value will also change. The ETag hash will be the same value as etag_id, and is marked as a weak entity tag string. For example: etag: W/"5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9", etag_id: 5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9

application/json

Schema

Schema

data objectrequired
iduuidrequired
The unique identifier for the Custom API Entry
typestringrequired
Specifies the type of the resource object, use the api_type of the Custom API for Custom API Entry.
links object
selfuri
Specifies the URI of the Custom API Entry.
Example: /extensions/wishlists/7e067539-6f6c-46e1-8c55-940031b36c6a
meta object
timestamps objectrequired
updated_atstringrequired
Specifies the date the entity is created.
Example: 2017-01-10T11:41:19.244Z
created_atstringrequired
Specifies the date the entity is last updated.
Example: 2017-01-10T11:41:19.244Z
data_sizeintegerrequired
Specifies the sum of the size of each value stored for the Custom API Entry in bytes. The total size of a Custom API Entry must not exceed 64KB.
Default value: 0
Example: 6
resource_versioninteger
A unique identifier representing the current version of the resource. When the resource changes, the resource_version value will also change.
Default value: 0
Example: 4
etag_idstring
A unique identifier representing the current version of the resource that is a hashed string. When the resource changes, the etag_id will also change.
Example: 6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b
property name*any

Example (auto)

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "string",
    "links": {
      "self": "/extensions/wishlists/7e067539-6f6c-46e1-8c55-940031b36c6a"
    },
    "meta": {
      "timestamps": {
        "updated_at": "2017-01-10T11:41:19.244Z",
        "created_at": "2017-01-10T11:41:19.244Z"
      },
      "data_size": 6,
      "resource_version": 4,
      "etag_id": "6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b"
    }
  }
}

valid_entry

Default Wishlist

{
  "data": {
    "id": "7e067539-6f6c-46e1-8c55-940031b36c6a",
    "type": "wishlist_ext",
    "name": "My Wishlist",
    "items_count": 0,
    "keep_purchased": false,
    "links": {
      "self": "/extensions/wishlists/7e067539-6f6c-46e1-8c55-940031b36c6a"
    },
    "meta": {
      "timestamps": {
        "updated_at": "2017-01-10T11:41:19.244Z",
        "created_at": "2017-01-10T11:41:19.244Z"
      },
      "resource_version": 0,
      "data_size": 6,
      "etag_id": "5feceb66ffc86f38d952786c6d696c79c2dbc239dd4e91b46729d73a27fb57e9"
    }
  }
}

400

Bad request. The request failed validation.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

missing-name

Required field missing

{
  "errors": [
    {
      "title": "Bad Request",
      "status": "400",
      "detail": "The field 'name' is required."
    }
  ]
}

403

Forbidden. You do not have permission to access this resource.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

forbidden-error

Forbidden error

{
  "errors": [
    {
      "title": "Forbidden",
      "status": "403",
      "detail": "You do not have permission to access this resource."
    }
  ]
}

409

Unable to perform the operation at this time.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

duplicate-custom-api

Duplicate Custom API

{
  "errors": [
    {
      "title": "Conflict",
      "status": "409",
      "detail": "custom_api with the given api_type already exists"
    }
  ]
}

duplicate-custom-field

Duplicate Custom Field

{
  "errors": [
    {
      "title": "Conflict",
      "status": "409",
      "detail": "custom_field with the given slug already exists"
    }
  ]
}

413

Payload Too Large. The total size of a Custom API Entry must not exceed 64KB.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

too-large

Requested entity too large

{
  "errors": [
    {
      "title": "Request Entity Too Large",
      "status": "413",
      "detail": "Maximum entry size reached."
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

internal-server-error

Internal server error

{
  "errors": [
    {
      "title": "Internal Server Error",
      "status": "500",
      "detail": "there was a problem processing your request"
    }
  ]
}

503

The service is temporarily unavailable. This request can be safely retried.

application/json

Schema

Schema

errors Error[]required
Array [
titlestringrequired
A brief summary of the error.
statusstringrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string"
    }
  ]
}

service-unavailable

Service Unavailable

{
  "errors": [
    {
      "detail": "An unknown error occurred",
      "status": "503",
      "title": "Service Unavailable"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://useast.api.elasticpath.com/v2/settings/extensions/custom-apis/:custom_api_id/entries");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent("{\n  \"data\": {\n    \"type\": \"string\"\n  }\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://useast.api.elasticpath.com

Auth

Bearer Token

Parameters

custom_api_id — pathrequired

Body

• Example (from schema)
• valid_entry

{
  "data": {
    "type": "string"
  }
}

ResponseClear

Click the Send API Request button above and see the response here!