Admin Feedback

Generated admin feedback operations.

GET/v1/admin/feedback/reportsRead or update the selected projectionadmin

Audience: Clients · Native API
Authorization: API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID: get_admin_feedback_reports

Parameters

Name	In	Type
`cursor`	query	`string`
`limit`	query	`integer \| ""`1–100
`status`	query	`string`
`kind`	query	`string`
`category`	query	`string`
`itemId`	query	`string`
`reporter`	query	`string`

Responses

200Successapplication/json

Example

{
  "data": {
    "filter": {
      "key": "string"
    },
    "items": [
      {
        "category": "string",
        "client": {
          "appVersion": "string",
          "online": true,
          "platform": "string"
        },
        "createdAt": "2026-10-18T19:30:00Z",
        "cursor": "eyJvIjoyMH0",
        "diagnostics": {
          "decision": "string",
          "detail": "string",
          "reference": "string"
        },
        "duplicateOf": "string",
        "duplicates": 0,
        "expiresAt": "2026-10-18T19:30:00Z",
        "id": "id_8h2k4q",
        "itemId": "id_8h2k4q",
        "kind": "string",
        "message": "string",
        "reporter": {
          "authority": "string",
          "name": "Fargo",
          "role": "string",
          "self": true
        },
        "revision": 0,
        "status": "string",
        "thread": [
          {}
        ],
        "updatedAt": "2026-10-18T19:30:00Z"
      }
    ],
    "nextCursor": "eyJvIjoyMH0",
    "observedAt": "2026-10-18T19:30:00Z",
    "statusCounts": {
      "key": 0
    },
    "total": 0
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}

Schema

dataobjectrequired
- filterobjectrequired
- itemsarray of objectrequired
  - categorystringrequired
  - clientobject
    appVersionstringrequired
    onlineboolean
    platformstringrequired
  - createdAtstringrequired
    RFC 3339 UTC instant; empty when absent.
  - cursorstringrequired
  - diagnosticsobjectrequired
    decisionstringrequired
    detailstring
    referencestring
  - duplicateOfstring
  - duplicatesintegerrequired
  - expiresAtstringrequired
    RFC 3339 UTC instant; empty when absent.
  - idstringrequired
  - itemIdstring
  - kindstringrequired
  - messagestringrequired
  - reporterobjectrequired
    authoritystringrequired
    namestringrequired
    rolestringrequired
    selfbooleanrequired
  - revisionintegerrequired
  - statusstringrequired
  - threadarray of objectrequired
    actorClassstringrequired
    atstringrequired
    RFC 3339 UTC instant; empty when absent.
    replystringrequired
    revisionintegerrequired
    sequenceintegerrequired
    statusstringrequired
  - updatedAtstringrequired
    RFC 3339 UTC instant; empty when absent.
- nextCursorstringrequired
- observedAtstringrequired
  RFC 3339 UTC instant; empty when absent.
- statusCountsobjectrequired
- totalintegerrequired
scopeobjectrequired
- serverIdstringrequired
- viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Schema

errorobjectrequired
- codestringrequired
- messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/feedback/reports" \
  -H "Authorization: Bearer $PORTICO_API_KEY"

GET/v1/admin/feedback/reports/{id}Read or update the selected projectionadmin

Audience: Clients · Native API
Authorization: API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID: get_admin_feedback_reports_id

Parameters

Name	In	Type	Description
`id`required	path	`string`

Responses

200Successapplication/json

Example

{
  "data": {
    "category": "string",
    "client": {
      "appVersion": "string",
      "online": true,
      "platform": "string"
    },
    "createdAt": "2026-10-18T19:30:00Z",
    "cursor": "eyJvIjoyMH0",
    "diagnostics": {
      "decision": "string",
      "detail": "string",
      "reference": "string"
    },
    "duplicateOf": "string",
    "duplicates": 0,
    "expiresAt": "2026-10-18T19:30:00Z",
    "id": "id_8h2k4q",
    "itemId": "id_8h2k4q",
    "kind": "string",
    "message": "string",
    "reporter": {
      "authority": "string",
      "name": "Fargo",
      "role": "string",
      "self": true
    },
    "revision": 0,
    "status": "string",
    "thread": [
      {
        "actorClass": "string",
        "at": "2026-10-18T19:30:00Z",
        "reply": "string",
        "revision": 0,
        "sequence": 0,
        "status": "string"
      }
    ],
    "updatedAt": "2026-10-18T19:30:00Z"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}

Schema

dataobjectrequired
- categorystringrequired
- clientobject
  - appVersionstringrequired
  - onlineboolean
  - platformstringrequired
- createdAtstringrequired
  RFC 3339 UTC instant; empty when absent.
- cursorstringrequired
- diagnosticsobjectrequired
  - decisionstringrequired
  - detailstring
  - referencestring
- duplicateOfstring
- duplicatesintegerrequired
- expiresAtstringrequired
  RFC 3339 UTC instant; empty when absent.
- idstringrequired
- itemIdstring
- kindstringrequired
- messagestringrequired
- reporterobjectrequired
  - authoritystringrequired
  - namestringrequired
  - rolestringrequired
  - selfbooleanrequired
- revisionintegerrequired
- statusstringrequired
- threadarray of objectrequired
  - actorClassstringrequired
  - atstringrequired
    RFC 3339 UTC instant; empty when absent.
  - replystringrequired
  - revisionintegerrequired
  - sequenceintegerrequired
  - statusstringrequired
- updatedAtstringrequired
  RFC 3339 UTC instant; empty when absent.
scopeobjectrequired
- serverIdstringrequired
- viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Schema

errorobjectrequired
- codestringrequired
- messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/admin/feedback/reports/{id}" \
  -H "Authorization: Bearer $PORTICO_API_KEY"

POST/v1/admin/feedback/reports/{id}/statusRead or update the selected projectionadmin

Audience: Clients · Native API
Authorization: API key or personal access token with the admin scope, or a signed-in session
OpenAPI operation ID: post_admin_feedback_reports_id_status
Max body: 1 MiB

Parameters

Name	In	Type	Description
`id`required	path	`string`

Request body application/json · required

Example

{
  "expectedRevision": 0,
  "operationId": "id_8h2k4q",
  "reply": "string",
  "status": "string"
}

Schema

expectedRevisionintegerrequired
operationIdstringrequired
replystringrequired
statusstringrequired

Responses

200Successapplication/json

Example

{
  "data": {
    "category": "string",
    "client": {
      "appVersion": "string",
      "online": true,
      "platform": "string"
    },
    "createdAt": "2026-10-18T19:30:00Z",
    "cursor": "eyJvIjoyMH0",
    "diagnostics": {
      "decision": "string",
      "detail": "string",
      "reference": "string"
    },
    "duplicateOf": "string",
    "duplicates": 0,
    "expiresAt": "2026-10-18T19:30:00Z",
    "id": "id_8h2k4q",
    "itemId": "id_8h2k4q",
    "kind": "string",
    "message": "string",
    "reporter": {
      "authority": "string",
      "name": "Fargo",
      "role": "string",
      "self": true
    },
    "revision": 0,
    "status": "string",
    "thread": [
      {
        "actorClass": "string",
        "at": "2026-10-18T19:30:00Z",
        "reply": "string",
        "revision": 0,
        "sequence": 0,
        "status": "string"
      }
    ],
    "updatedAt": "2026-10-18T19:30:00Z"
  },
  "scope": {
    "serverId": "id_8h2k4q",
    "viewerFence": "string"
  }
}

Schema

dataobjectrequired
- categorystringrequired
- clientobject
  - appVersionstringrequired
  - onlineboolean
  - platformstringrequired
- createdAtstringrequired
  RFC 3339 UTC instant; empty when absent.
- cursorstringrequired
- diagnosticsobjectrequired
  - decisionstringrequired
  - detailstring
  - referencestring
- duplicateOfstring
- duplicatesintegerrequired
- expiresAtstringrequired
  RFC 3339 UTC instant; empty when absent.
- idstringrequired
- itemIdstring
- kindstringrequired
- messagestringrequired
- reporterobjectrequired
  - authoritystringrequired
  - namestringrequired
  - rolestringrequired
  - selfbooleanrequired
- revisionintegerrequired
- statusstringrequired
- threadarray of objectrequired
  - actorClassstringrequired
  - atstringrequired
    RFC 3339 UTC instant; empty when absent.
  - replystringrequired
  - revisionintegerrequired
  - sequenceintegerrequired
  - statusstringrequired
- updatedAtstringrequired
  RFC 3339 UTC instant; empty when absent.
scopeobjectrequired
- serverIdstringrequired
- viewerFencestringrequired

defaultRequest refused or unavailableapplication/json

Example

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Schema

errorobjectrequired
- codestringrequired
- messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busywriter_capacity

Example request

curl -X POST "http://127.0.0.1:32500/v1/admin/feedback/reports/{id}/status" \
  -H "Authorization: Bearer $PORTICO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expectedRevision":0,"operationId":"id_8h2k4q","reply":"string","status":"string"}'