Register a queue target for the given event stream
Polymorphic body discriminated by `type` (`aws_sqs`, `azure_event_hubs`, `azure_storage_queue`). Validated by a synthetic test publish before persisting; on test-publish failure returns `400 invalid_request` with the underlying provider error and no configuration is stored. `409 queue_already_configured` if a config exists — use `PUT` to replace.
Authorization
OrgId Tenant identifier resolved by Kong from the authenticated taih-tenant-key. Required on partner-scoped routes (e.g. POST /v1/users, POST /v1/auth/token, /v1/admin/*). In production Kong injects this header after validating the tenant key; local-dev callers must set it themselves.
In: header
Path Parameters
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://loading/v1/admin/org/queues/string" \ -H "Content-Type: application/json" \ -d '{ "queue_name": "string", "type": "aws_sqs" }'{
"data": {
"queue_name": "string",
"type": "aws_sqs",
"aws_sqs": {
"queue_arn": "string",
"region": "string",
"role_arn": "string",
"publishing_principal_arn": "string"
},
"azure_event_hubs": {
"namespace": "string",
"event_hub_name": "string"
},
"azure_storage_queue": {
"account_name": "string",
"queue_name": "string"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Retrieve the configured queue (metadata only)
Returns the queue config minus any write-only secrets (SAS tokens). `404 queue_not_configured` if the named stream has no queue registered — events for unconfigured streams are buffered until a queue is registered.
Remove the queue target
Subsequent events for this stream are buffered until a new queue is registered. Returns `204 No Content` on success.