Approval requests

List publishing approval requests

Changed on

Returns publishing approval requests owned by the authenticated Account. Each request asks to publish one Project; requests to allow public publishing are a separate flow. Without a status filter, only pending requests are returned. Use a comma-separated status list to include other lifecycle states.

Results are ordered by creation time, newest first. Cursors are bound to the Account and the effective status, workspaceId, projectId, and limit settings. Reusing a cursor with different effective filters or a different limit returns invalid_request. Explicit default values and reordered or repeated statuses do not change these settings.

Requests remain accessible to the Account that received them after a Project moves. A Project outside that Account has a null workspaceId; destination details are not returned. Account and Project-filtered lists include these retained requests. Workspace filters select only Projects currently in that Account's Workspace.

Every item includes an opaque reviewEtag. Copy the complete quoted value unchanged into If-Match on the matching review route; do not parse it or use the collection HTTP ETag. This enables review without a detail GET. A detail GET remains optional when event history or the detail ETag is needed.

Requesters are represented by requesterUserId, not a user profile. List entries do not include event history; use the detail operation to retrieve it.

get/projects/publishing-requests

Request

  • Base URL
    https://api.replit.com/v1
  • Auth
    HTTP bearer

Query parameters

statusPublishingRequestStatus[]
workspaceIdstring

Restrict results to a workspace owned by the authenticated Account.

projectIdstring uuid

Restrict results to the stored Project ID on requests owned by the authenticated Account, including requests retained after that Project moves to another Account.

limitinteger

Maximum number of records to return.

cursorstring

Opaque pagination cursor returned by the previous response.

Response

Publishing approval request list.

Example response

{
  "data": [
    {
      "reviewEtag": "\"3.47DEQpj8HBSa-_TI\""
    }
  ]
}

Changes