Api reference
Replace the existing queue target
Use to switch types (e.g. AWS SQS → Azure Event Hubs), rotate a SAS token, or update a role ARN. Same polymorphic body as `POST`. Validated by a synthetic test publish; on failure the previous configuration is left untouched.
Authorization
OrgId org-id<token>
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
queue_name*Queue Name
Header Parameters
org-id?string|null
x-user-id?string|null
x-request-id?string|null
traceparent?string|null
Idempotency-Key?|null
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X PUT "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"
}
]
}