SalesChannelFailedIntegrations

Retrieve Sales Failed Integration by ID

get

Retrieve a specific Sales Channel Failed Integration by ID

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
200
Sales Channel Failed Integration retrieved successfully
application/json
get
GET /api/v1/channel/{channel_id}/failed_integrations/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "pk": 1,
  "channel": 1,
  "version_date": "2025-06-27T08:38:26.936Z",
  "reason_type": "mapping",
  "is_active": true,
  "content_type": 1,
  "object_id": 1,
  "expiration_date": "2025-06-27T08:38:26.936Z",
  "retry_count": 1,
  "max_retry_count": 1,
  "retry_interval": 0,
  "integration_action": 1,
  "log_id": 1
}

Update Sales Channel Failed Integration

put

Update a specific Sales Channel Failed Integration by ID

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Body
pkintegerRead-onlyOptional

Unique identifier for the failed integration

channelintegerRequired

Foreign key to Channel model

version_datestring · date-timeRequired

Version date of the integration attempt (indexed)

reason_typestring · enum · max: 15Required

Type of reason for failure

Possible values:
is_activebooleanOptional

Whether the failed integration is active

Default: true
content_typeintegerRequired

Foreign key to ContentType model for polymorphic relationship

object_idintegerRequired

ID of the related object

expiration_datestring · date-time | nullableOptional

Date when the failed integration record expires

retry_countintegerOptional

Number of retry attempts made

Default: 1
max_retry_countintegerOptional

Maximum number of retry attempts allowed

Default: 1
retry_intervalintegerOptional

Interval between retry attempts in seconds

Default: 0
integration_actioninteger | nullableOptional

Foreign key to IntegrationAction model

log_idinteger | nullableOptional

ID reference to related log entry

Responses
200
Sales Channel Failed Integration updated
put
PUT /api/v1/channel/{channel_id}/failed_integrations/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "channel": 1,
  "version_date": "2025-06-27T08:38:26.936Z",
  "reason_type": "mapping",
  "is_active": true,
  "content_type": 1,
  "object_id": 1,
  "expiration_date": "2025-06-27T08:38:26.936Z",
  "retry_count": 1,
  "max_retry_count": 1,
  "retry_interval": 0,
  "integration_action": 1,
  "log_id": 1
}

No content

Delete Sales Channel Failed Integration

delete

Delete Sales Channel Failed Integration for a specific channel.

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Responses
204
Sales Channel Failed Integration deleted successfully
delete
DELETE /api/v1/channel/{channel_id}/failed_integrations/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Partial Update Sales Channel Failed Integration

patch

Partial update a specific Sales Channel Failed Integration by ID

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
idintegerRequired

Unique identifier of the resource

Example: 1
Body
pkintegerRead-onlyOptional

Unique identifier for the failed integration

channelintegerRequired

Foreign key to Channel model

version_datestring · date-timeRequired

Version date of the integration attempt (indexed)

reason_typestring · enum · max: 15Required

Type of reason for failure

Possible values:
is_activebooleanOptional

Whether the failed integration is active

Default: true
content_typeintegerRequired

Foreign key to ContentType model for polymorphic relationship

object_idintegerRequired

ID of the related object

expiration_datestring · date-time | nullableOptional

Date when the failed integration record expires

retry_countintegerOptional

Number of retry attempts made

Default: 1
max_retry_countintegerOptional

Maximum number of retry attempts allowed

Default: 1
retry_intervalintegerOptional

Interval between retry attempts in seconds

Default: 0
integration_actioninteger | nullableOptional

Foreign key to IntegrationAction model

log_idinteger | nullableOptional

ID reference to related log entry

Responses
200
Sales Channel Failed Integration updated
patch
PATCH /api/v1/channel/{channel_id}/failed_integrations/{id}/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "channel": 1,
  "version_date": "2025-06-27T08:38:26.936Z",
  "reason_type": "mapping",
  "is_active": true,
  "content_type": 1,
  "object_id": 1,
  "expiration_date": "2025-06-27T08:38:26.936Z",
  "retry_count": 1,
  "max_retry_count": 1,
  "retry_interval": 0,
  "integration_action": 1,
  "log_id": 1
}

No content

List Sales Channel Failed Integrations

get

List Sales Channel Failed Integrations

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Query parameters
pageinteger · min: 1Optional

Specifies the page number of the current dataset

Default: 1
limitinteger · min: 1Optional

Indicates the number of rows on the current page.

Default: 10
channelintegerOptional

ID of the channel the customer belongs to

Example: 5
Responses
200
OK
application/json
get
GET /api/v1/channel/{channel_id}/failed_integrations/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Accept: */*
{
  "count": 0,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "pk": 1,
      "channel": 1,
      "version_date": "2025-06-27T08:38:26.936Z",
      "reason_type": "mapping",
      "is_active": true,
      "content_type": 1,
      "object_id": 1,
      "expiration_date": "2025-06-27T08:38:26.936Z",
      "retry_count": 1,
      "max_retry_count": 1,
      "retry_interval": 0,
      "integration_action": 1,
      "log_id": 1
    }
  ]
}

Create Sales Channel Failed Integration

post

Create Sales Channel Failed Integration for a specific channel.

Authorizations
Path parameters
channel_idintegerRequired

The channel ID of the resource.

Example: 5
Body
pkintegerRead-onlyOptional

Unique identifier for the failed integration

channelintegerRequired

Foreign key to Channel model

version_datestring · date-timeRequired

Version date of the integration attempt (indexed)

reason_typestring · enum · max: 15Required

Type of reason for failure

Possible values:
is_activebooleanOptional

Whether the failed integration is active

Default: true
content_typeintegerRequired

Foreign key to ContentType model for polymorphic relationship

object_idintegerRequired

ID of the related object

expiration_datestring · date-time | nullableOptional

Date when the failed integration record expires

retry_countintegerOptional

Number of retry attempts made

Default: 1
max_retry_countintegerOptional

Maximum number of retry attempts allowed

Default: 1
retry_intervalintegerOptional

Interval between retry attempts in seconds

Default: 0
integration_actioninteger | nullableOptional

Foreign key to IntegrationAction model

log_idinteger | nullableOptional

ID reference to related log entry

Responses
201
Failed Integration Created
application/json
post
POST /api/v1/channel/{channel_id}/failed_integrations/ HTTP/1.1
Host: sandbox.akinon.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 261

{
  "channel": 1,
  "version_date": "2025-06-27T08:38:26.936Z",
  "reason_type": "mapping",
  "is_active": true,
  "content_type": 1,
  "object_id": 1,
  "expiration_date": "2025-06-27T08:38:26.936Z",
  "retry_count": 1,
  "max_retry_count": 1,
  "retry_interval": 0,
  "integration_action": 1,
  "log_id": 1
}
{
  "pk": 1,
  "channel": 1,
  "version_date": "2025-06-27T08:38:26.936Z",
  "reason_type": "mapping",
  "is_active": true,
  "content_type": 1,
  "object_id": 1,
  "expiration_date": "2025-06-27T08:38:26.936Z",
  "retry_count": 1,
  "max_retry_count": 1,
  "retry_interval": 0,
  "integration_action": 1,
  "log_id": 1
}

Was this helpful?