Acknowledge messages from the server
  • 26 Mar 2024
  • 3 Minutes to read
  • Dark
    Light

Acknowledge messages from the server

  • Dark
    Light

Article summary

Post
/v2/tenants/{tenantId}/projects/{projectId}/subscriptions/{sub}:acknowledge

Acknowledge messages from the server.

Security
API Key
Header parameter nameAuthorization

AWS Cognito Authorizer. Since there are no custom scopes the ID Token must be used for authorization

Header parameters
Content-Type
stringRequired
Path parameters
tenantId
stringRequired

The RapidIdentity Cloud tenant id

projectId
stringRequired

The project id this service belongs (i.e. sm, idhub, ric)

sub
stringRequired

The queue name.

Body parameters

The number of messages to acknowledge.

object
ackIds
Array of string

The server assigned acknowledgement ID for the messages being acknowledged that was returned by the Pub/Sub system in the subscriptions pull response. Must not be empty

string
Responses
204

No content is returned

Headers
Cache-Control
string
400

An issue with how the request was formatted

Headers
Content-Type
string
Content-Length
string
Cache-Control
string
Expand All
object
error
object

The error message description

errors
Array of object

The more detailed information about the error message

object
domain
string

The service where the error occured. i.e. sm, idhub

reason
string

The reason for the error based on Identity Automation common error codes

message
string

Additional details about the error

locationType
string

The specific location where the error occurred. i.e. parameter, content

location
string

The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

code
string

The http status code

message
string

Additional details about the error

401

The request is not authorized. Ensure you are using an ID Token in your request and it is not expired

Headers
Content-Type
string
Content-Length
string
Cache-Control
string
Expand All
object
error
object

The error message description

errors
Array of object

The more detailed information about the error message

object
domain
string

The service where the error occured. i.e. sm, idhub

reason
string

The reason for the error based on Identity Automation common error codes

message
string

Additional details about the error

locationType
string

The specific location where the error occurred. i.e. parameter, content

location
string

The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

code
string

The http status code

message
string

Additional details about the error

403

The authorization token does not have access to the RapidIdentity Cloud Tenant. Ensure the tenantId used for authentication is the same one used in this request.

Headers
Content-Type
string
Content-Length
string
Cache-Control
string
Expand All
object
error
object

The error message description

errors
Array of object

The more detailed information about the error message

object
domain
string

The service where the error occured. i.e. sm, idhub

reason
string

The reason for the error based on Identity Automation common error codes

message
string

Additional details about the error

locationType
string

The specific location where the error occurred. i.e. parameter, content

location
string

The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

code
string

The http status code

message
string

Additional details about the error

404

The requested operation failed because a resource associated with the request could not be found

Headers
Content-Type
string
Content-Length
string
Cache-Control
string
Expand All
object
error
object

The error message description

errors
Array of object

The more detailed information about the error message

object
domain
string

The service where the error occured. i.e. sm, idhub

reason
string

The reason for the error based on Identity Automation common error codes

message
string

Additional details about the error

locationType
string

The specific location where the error occurred. i.e. parameter, content

location
string

The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

code
string

The http status code

message
string

Additional details about the error

405

The operation must be included and it must be acknowledge

Expand All
object
error
object

The error message description

errors
Array of object

The more detailed information about the error message

object
domain
string

The service where the error occured. i.e. sm, idhub

reason
string

The reason for the error based on Identity Automation common error codes

message
string

Additional details about the error

locationType
string

The specific location where the error occurred. i.e. parameter, content

location
string

The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

code
string

The http status code

message
string

Additional details about the error

503

Unable to connect to pubsub service

Headers
Content-Type
string
Content-Length
string
Cache-Control
string
Expand All
object
error
object

The error message description

errors
Array of object

The more detailed information about the error message

object
domain
string

The service where the error occured. i.e. sm, idhub

reason
string

The reason for the error based on Identity Automation common error codes

message
string

Additional details about the error

locationType
string

The specific location where the error occurred. i.e. parameter, content

location
string

The higher level location of what was trying to be accessed. i.e. pullMessages, publishMessage

code
string

The http status code

message
string

Additional details about the error


Was this article helpful?