Go to home page
Docs API Reference

Asset Programs

An Asset Program is a container for one or more Asset Types .

Asset Program Model

Attributes

  • id

    string

    The unique identifier of the Asset Program.

  • name

    string

    The display name of the Asset Program.

  • assetTypes

    array

    One or more Asset Types that can be accepted as part of the Asset Program.

  • accountId

    string

    The Account that owns the Asset Program.

  • test

    boolean

    true if the Asset Program is for testing purposes only. This is based on the Account that owns the Asset Program.

  • mediaUploadId

    string

    The id of the Media Upload image of the Asset Program.

  • createdAt

    timestamp

    When the Asset Program was created.

  • createdBy

    crn

    The User or API Key that created the Asset Program.

  • updatedAt

    timestamp

    When the Asset Program was updated.

  • updatedBy

    crn

    The User or API Key that updated the Asset Program.

Create Asset Program experimental

This endpoint allows you to create an Asset Program .

Attributes

  • name

    string required

    The display name of the Asset Program.

  • accountId

    string required

    The Account that will own the Asset Program.

  • assetTypes

    array required

    The list of Asset Types that are a part of the Asset Program.

  • mediaUploadId

    string

    The id of the Media Upload image of the Asset Program.

Errors

  • ACCOUNT_TYPE_INVALID

    403

    The Account must be type org.

  • MEDIA_UPLOAD_INVALID

    403

    The media upload id does not reference a media upload.

Request
curl -X POST \
 https://service.centrapay.com/api/asset-programs \
 -H 'content-type: application/json' \
 -H 'x-api-key: <TOKEN>' \
 -d '
{
 "name": "My Asset Program",
 "assetTypes": [
  "payap-debit"
 ],
 "mediaUploadId": "8aoMfscvtuewsuJzmzBzAs",
 "accountId": "Jaim1Cu1Q55uooxSens6yk"
}
'
Response
{
  "id": "WRhAxxWpTKb5U7pXyxQjjY",
  "accountId": "Jaim1Cu1Q55uooxSens6yk",
  "assetTypes": [
    "payap-debit"
  ],
  "createdAt": "2021-08-25T00:02:49.488Z",
  "createdBy": "crn::user:b657195e-dc2f-11ea-8566-e7710d592c99",
  "mediaUploadId": "8aoMfscvtuewsuJzmzBzAs",
  "name": "My Asset Program",
  "test": true,
  "updatedAt": "2021-08-25T00:02:49.488Z",
  "updatedBy": "crn::user:b657195e-dc2f-11ea-8566-e7710d592c99"
}