ForbiddenErrorData

Which scopes the endpoint needed and which the key held.

  • granted
    Type: array string[] enum
    required

    The scopes the calling key holds.

    values
    • *

      Full access — everything your key is allowed to do.

    • inventory:read

      Read your inventory.

    • inventory:write

      Change your inventory — create, update, and delete lines, tags, and locations.

    • listings:read

      Read your Marketplace listings.

    • listings:write

      Change your Marketplace listings — publish, reprice, and delist.

  • required
    Type: array string[] enum
    required

    The scopes this endpoint requires.

    values
    • *

      Full access — everything your key is allowed to do.

    • inventory:read

      Read your inventory.

    • inventory:write

      Change your inventory — create, update, and delete lines, tags, and locations.

    • listings:read

      Read your Marketplace listings.

    • listings:write

      Change your Marketplace listings — publish, reprice, and delist.

Examples
{
  "required": [
    "inventory:write"
  ],
  "granted": [
    "account:read",
    "inventory:read"
  ]
}