ovahub
Skip to documentation
DocumentationAPI referenceRead team firewall creation receipt
GETBearer token

Read team firewall creation receipt

/api/v1/firewall-requests/:requestKey

Read a submitted firewall creation receipt from the fixed current team, including its original actor.

Before you call

Business read only: never submits, retries, unlocks or calls the supplier. A missing receipt does not prove that nothing was created. Historical success does not confirm current protection. Existing authentication usage auditing remains.

Request example

cURL
curl "https://tovahub.com/api/v1/firewall-requests/undefined" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "requestKey": "original_create_1",
  "actorUserId": "507f1f77bcf86cd799439013",
  "name": "Office",
  "state": "pending",
  "createdAt": "2026-11-01T00:00:00.000Z",
  "updatedAt": "2026-11-01T00:00:00.000Z",
  "resource": null
}

Parameters

requestKeyPath · Required

string

Original creation requestKey. Recovery never allocates a new key.

Response

HTTP status 200

Saved receipt only; no provider verification or operation retry occurs.

requestKeystring | null

Original key, or null for incomplete legacy records.

namestring | null

Saved creation name, or null. Rules and raw provider data are not returned.

statestring

Saved state: new, started, pending, succeeded, failed or unknown. No state authorizes resubmission.

createdAtstring | null

Saved ISO timestamp, or null when unavailable. Reads do not update it.

updatedAtstring | null

Saved ISO timestamp, or null when unavailable. Reads do not update it.

resource{ id: string, state: string } | null

Same-organization local resource {id, state}, or null. Deleted or missing resources are never recreated.

actorUserIdstring (ObjectId) | null

Original actor account ID, or null for incomplete history. The current reader must be an active member of the same fixed team.

Related

Requests & errorsAuthenticationMCP · get_firewall_request