Approvals

get

Returns a list of approval requests

Path parameters
environmentstringRequired
Query parameters
pageintegerOptional

The page number to be returned, must be greater than zero. Defaults to 1.

Example: 1
pageSizeintegerRequired

The elements amount on a single page, must be greater than zero.

Example: 25
sortFieldstring · enumOptional

The field to sort results by

Possible values:
sortOrderstring · enumOptional

Sorting order. Defaults to ascending

Possible values:
entityNamestringOptional

filter request by matching entity names

Responses
200Success
application/json
get
/api/v1/environments/{environment}/proxy/api/v1/approvals
GET /api/v1/environments/{environment}/proxy/api/v1/approvals?pageSize=1 HTTP/1.1
Host: 
Accept: */*
{
  "values": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "entityName": "text",
      "type": "Create",
      "entityType": "KafkaTopic",
      "settings": {
        "replication": 1,
        "partitions": 1,
        "topicConfig": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        },
        "capacity": {
          "recordsSize": 1,
          "dataProducedPerDay": 1,
          "consumers": 1
        }
      },
      "metadata": {
        "reason": "text",
        "tags": [
          "text"
        ]
      },
      "createdAt": "2025-10-24T16:21:34.157Z",
      "createdBy": "text",
      "approvalStatus": "Approved",
      "rejectionReason": "text",
      "failureReason": "text",
      "reviewedBy": "text",
      "reviewedAt": "2025-10-24T16:21:34.157Z",
      "defaultTopicConfig": {
        "ANY_ADDITIONAL_PROPERTY": {
          "default": "text",
          "serverDefaultProperties": "text",
          "description": "text"
        }
      }
    }
  ],
  "pagesAmount": 1,
  "totalCount": 1
}
post

Creates a new approval request

Path parameters
environmentstringRequired
Body
one ofOptional
or
or
Responses
200Success
application/json
post
/api/v1/environments/{environment}/proxy/api/v1/approvals
POST /api/v1/environments/{environment}/proxy/api/v1/approvals HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 321

{
  "entityName": "topic-invoices",
  "entityType": "KafkaTopic",
  "settings": {
    "replication": 2,
    "partitions": 5,
    "topicConfig": {
      "delete.retention.ms": "30000"
    },
    "capacity": {
      "recordsSize": 15
    }
  },
  "metadata": {
    "reason": "A topic to store invoice records produced by our billing app Foo",
    "tags": [
      "billing",
      "invoices"
    ]
  },
  "type": "CreateNewEntity"
}
{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}
get

Returns the approval request details

Path parameters
environmentstringRequired
idstring · uuidRequired

The request id

Responses
200Success
application/json
get
/api/v1/environments/{environment}/proxy/api/v1/approvals/{id}
GET /api/v1/environments/{environment}/proxy/api/v1/approvals/{id} HTTP/1.1
Host: 
Accept: */*
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "entityName": "text",
  "type": "Create",
  "entityType": "KafkaTopic",
  "settings": {
    "replication": 1,
    "partitions": 1,
    "topicConfig": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "capacity": {
      "recordsSize": 1,
      "dataProducedPerDay": 1,
      "consumers": 1
    }
  },
  "metadata": {
    "reason": "text",
    "tags": [
      "text"
    ]
  },
  "createdAt": "2025-10-24T16:21:34.157Z",
  "createdBy": "text",
  "approvalStatus": "Approved",
  "rejectionReason": "text",
  "failureReason": "text",
  "reviewedBy": "text",
  "reviewedAt": "2025-10-24T16:21:34.157Z",
  "defaultTopicConfig": {
    "ANY_ADDITIONAL_PROPERTY": {
      "default": "text",
      "serverDefaultProperties": "text",
      "description": "text"
    }
  }
}
put

Approves the request

Path parameters
environmentstringRequired
idstring · uuidRequired
Responses
204Success

No content

put
/api/v1/environments/{environment}/proxy/api/v1/approvals/{id}/approve
PUT /api/v1/environments/{environment}/proxy/api/v1/approvals/{id}/approve HTTP/1.1
Host: 
Accept: */*

No content

put

Rejects the approval request

Path parameters
environmentstringRequired
idstring · uuidRequired
Body
rejectionReasonstringOptional
Responses
204Success

No content

put
/api/v1/environments/{environment}/proxy/api/v1/approvals/{id}/reject
PUT /api/v1/environments/{environment}/proxy/api/v1/approvals/{id}/reject HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "rejectionReason": "text"
}

No content

Last updated

Was this helpful?