API

Recover one encrypted asset lookup result

Generated from the checked-in source. Do not edit this reference by hand.

GET /api/v1/vendors/{id}/asset-management/lookups/{lookup}

Platform administrator only. Requires exact original grants/account/credentials and unexpired retained content. Authenticated workspace/lookup context; safe validated asset fields only. No upstream request, URL, upstream identity, raw error or billing mutation. Cache-Control no-store. Source listing and lookup results have independent retention domains.

Operation: get--api-v1-vendors--id--asset-management-lookups--lookup-.

Authentication

Use the credential and permission scope described above. Each object below is an alternative; schemes within one object are required together.

[
  {
    "adminBearerAuth": []
  }
]

HTTP request

Set NIU_ORIGIN to your installation origin (without /v1). Replace path, query and header placeholders with the required values. Query examples use curl 7.87 or newer to encode values with --url-query. Use the credential scope described above; a bearer token must have the authority required by this operation.

curl --fail-with-body -X GET "$NIU_ORIGIN/api/v1/vendors/{id}/asset-management/lookups/{lookup}" \
  -H "Authorization: Bearer $NIU_ADMIN_TOKEN" \
  --url-query 'organization_id=<ORGANIZATION_ID>' \
  --url-query 'project_id=<PROJECT_ID>'

Parameters

id

Location: path. Required.

{
  "type": "string",
  "format": "uuid"
}

lookup

Location: path. Required.

{
  "type": "string",
  "format": "uuid"
}

organization_id

Location: query. Required.

{
  "type": "string",
  "format": "uuid"
}

project_id

Location: query. Required.

{
  "type": "string",
  "format": "uuid"
}

Request body

No request body is declared.

Responses

HTTP 200

Safe retained lookup details.

Content type: application/json.

{
  "type": "object",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "lookup_id",
        "asset"
      ],
      "properties": {
        "lookup_id": {
          "type": "string",
          "format": "uuid"
        },
        "asset": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "name",
            "status",
            "asset_type",
            "created_at",
            "updated_at",
            "last_inference_at"
          ],
          "properties": {
            "name": {
              "type": "string",
              "maxLength": 64
            },
            "status": {
              "type": "string",
              "enum": [
                "Active",
                "Processing",
                "Failed"
              ]
            },
            "asset_type": {
              "type": "string",
              "enum": [
                "Image",
                "Video",
                "Audio"
              ]
            },
            "created_at": {
              "type": "string",
              "format": "date-time"
            },
            "updated_at": {
              "type": "string",
              "format": "date-time"
            },
            "last_inference_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          }
        }
      }
    }
  }
}

HTTP 401

Authentication required.

HTTP 403

Platform administrator required.

HTTP 404

Missing, expired, erased, revoked or out-of-scope result.

HTTP 503

Safe decryption or validation failure.