/v1/channel-connections/{id}/listings (POST)

POST

/v1/channel-connections/{id}/listings

curl --request POST \
  --url http://localhost:8787/v1/channel-connections/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/listings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "resourceId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

• Local development (`wrangler dev --env dev`).
• Staging — placeholder host; real custom domain not yet provisioned.
• Production — placeholder host; real custom domain not yet provisioned.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body

Media typeapplication/json

object

resourceId

required

string format: uuid

Example^generated

{
  "resourceId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

201

Maps this resource to this connection — required before any import can write blocks for it.

Media typeapplication/json

object

connectionId

required

string format: uuid

id

required

string format: uuid

resourceId

required

string format: uuid

Example^generated

{
  "connectionId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "resourceId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

404

No such channel connection, or no such resource, for this tenant.

Media typeapplication/problem+json

object

code

required

string

Allowed values: resource_not_found feed_token_not_found connection_not_found listing_already_mapped conflict_not_found invalid_cursor already_resolved

detail

required

string

status

required

number

title

required

string

type

required

string

Example

{
  "code": "resource_not_found"
}

409

This resource is already mapped to this connection.

Media typeapplication/problem+json

object

code

required

string

Allowed values: resource_not_found feed_token_not_found connection_not_found listing_already_mapped conflict_not_found invalid_cursor already_resolved

detail

required

string

status

required

number

title

required

string

type

required

string

Example

{
  "code": "resource_not_found"
}