> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-cloud-api/aspm-cicd-and-application-security/attestation-public-keys.md).

# Attestation Public Keys

Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.

#### Conventions

* `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.
* The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.
* The update and delete endpoints return no body. A successful call returns `200` with an empty response.

#### Error format

Every expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:

```json
{
  "errorMessage": "human-readable description",
  "errorStatus": "PUBLIC_KEY_NOT_REGISTERED"
}
```

Unexpected failures are handled by the platform's generic 500 handler and don't include this body.

## Check whether a key type is supported

> Validate a public key without registering it. This is the quickest way to check a key before you add it.\
> \
> An unsupported key still returns \`200\`. The result is in the response body, not the status code.\
> \
> To validate a key file directly without escaping the PEM manually, run the following command, and then pass \`-d @body.json\` in your request:\
> \
> \`\`\`bash\
> jq -Rs '{publicKey: .}' < mykey.pub > body.json\
> \`\`\`\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\`) or CLI Tool (\`ci\_tool\_view\`) set to View.\
> \
> \*\*Required license:\*\* Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.

````json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex Cloud"},"tags":[{"name":"Attestation public keys","description":"Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.\n\n### Conventions\n\n- `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.\n- The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.\n- The update and delete endpoints return no body. A successful call returns `200` with an empty response.\n\n### Error format\n\nEvery expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:\n\n```json\n{\n  \"errorMessage\": \"human-readable description\",\n  \"errorStatus\": \"PUBLIC_KEY_NOT_REGISTERED\"\n}\n```\n\nUnexpected failures are handled by the platform's generic 500 handler and don't include this body."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/public-key/is-key-type-supported":{"post":{"operationId":"IsKeyTypeSupported","tags":["Attestation public keys"],"summary":"Check whether a key type is supported","description":"Validate a public key without registering it. This is the quickest way to check a key before you add it.\n\nAn unsupported key still returns `200`. The result is in the response body, not the status code.\n\nTo validate a key file directly without escaping the PEM manually, run the following command, and then pass `-d @body.json` in your request:\n\n```bash\njq -Rs '{publicKey: .}' < mykey.pub > body.json\n```\n\n**Required role:** Any role with the Asset Inventory (`asset_management`) or CLI Tool (`ci_tool_view`) set to View.\n\n**Required license:** Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.","responses":{"200":{"description":"The validation result.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicKeyValidationResult"},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true}],"requestBody":{"required":true,"description":"Public key to validate.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IsKeyTypeSupportedBody"}}}}}}},"components":{"schemas":{"PublicKeyValidationResult":{"description":"Result of validating a public key. Cosign supports ECDSA P-256, Ed25519, and RSA 2048, 3072, and 4096.","properties":{"supported":{"type":"boolean","description":"Whether the key type is supported. An unsupported key still returns `200`, so check this field for the result."},"keyType":{"type":"string","enum":["ecdsa","ed25519","rsa"],"description":"Algorithm of the key.\n- `ecdsa`: ECDSA key.\n- `ed25519`: Ed25519 key.\n- `rsa`: RSA key."},"curveOrSize":{"type":"string","description":"ECDSA curve name or RSA key size, for example, `P-256`."},"normalizedPem":{"type":"string","description":"Canonical SPKI PEM re-exported from the parsed key, so only validated bytes are persisted."},"fingerprint":{"type":"string","description":"Fingerprint of the key."},"reason":{"type":"string","description":"Reason the key isn't supported. Returned when `supported` is `false`. Typical values include `empty input`, `input exceeds maximum allowed size`, and `KMS key references are not supported (expected a PEM public key)`."}},"required":["supported"],"type":"object","additionalProperties":false},"AttestationErrorResponse":{"description":"Response body returned for every expected error.","properties":{"errorMessage":{"type":"string","description":"Human-readable description of the error."},"errorStatus":{"$ref":"#/components/schemas/AttestationErrorStatus"}},"required":["errorMessage","errorStatus"],"type":"object","additionalProperties":false},"AttestationErrorStatus":{"description":"Error code that identifies the type of failure.\n- `PUBLIC_KEY_NOT_REGISTERED` (404): The named key doesn't exist.\n- `PUBLIC_KEY_ALREADY_REGISTERED` (409): You tried to add a key with a name that's already taken.\n- `UNSUPPORTED_PUBLIC_KEY_TYPE` (400): The supplied key isn't a supported type.\n- `INVALID_ROTATION_POLICY` (400): The rotation policy isn't valid.\n- `BAD_ROTATION_UPDATE` (400): The rotation change isn't allowed.\n- `INVALID_PRESIGNED_URL` (400): A supplied presigned URL is malformed or doesn't use HTTPS.\n- `INVALID_REQUEST_PARAMS`: The request parameters aren't valid.\n- `PIPELINE_NOT_FOUND` (404): The pipeline ID doesn't exist.\n- `NETWORK_ISSUE` (500): A downstream call failed.\n- `UNKNOWN_ERROR` (500): An unclassified failure occurred.","enum":["PUBLIC_KEY_NOT_REGISTERED","PUBLIC_KEY_ALREADY_REGISTERED","UNSUPPORTED_PUBLIC_KEY_TYPE","INVALID_ROTATION_POLICY","BAD_ROTATION_UPDATE","INVALID_PRESIGNED_URL","INVALID_REQUEST_PARAMS","PIPELINE_NOT_FOUND","NETWORK_ISSUE","UNKNOWN_ERROR"],"type":"string"},"BillingErrorResponse":{"type":"object","properties":{"reply":{"type":"object","properties":{"err_code":{"type":"integer","description":"The HTTP status code of the error."},"err_msg":{"type":"string","description":"A short description of the error type."},"err_extra":{"type":"string","description":"A detailed message explaining the cause of the error.","nullable":true}}}}},"IsKeyTypeSupportedBody":{"description":"Request body for validating a public key.","properties":{"publicKey":{"type":"string","description":"PEM-encoded public key to validate. The PEM must be JSON-escaped (real newlines become `\\n`)."}},"required":["publicKey"],"type":"object","additionalProperties":false}},"responses":{"Unauthorized":{"description":"Unauthorized - The request is unauthenticated. Pass the correct auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}},"Forbidden":{"description":"Forbidden - Access to the resource is prohibited. Try with different auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}}}}}
````

## Check whether a public key exists

> Check whether a public key with the specified name is registered.\
> \
> A key that was never registered returns \`{ "exists": false }\` with a \`200\` status. This is an answer, not an error.\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\`) or CLI Tool (\`ci\_tool\_view\`) set to View.\
> \
> \*\*Required license:\*\* Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.

````json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex Cloud"},"tags":[{"name":"Attestation public keys","description":"Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.\n\n### Conventions\n\n- `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.\n- The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.\n- The update and delete endpoints return no body. A successful call returns `200` with an empty response.\n\n### Error format\n\nEvery expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:\n\n```json\n{\n  \"errorMessage\": \"human-readable description\",\n  \"errorStatus\": \"PUBLIC_KEY_NOT_REGISTERED\"\n}\n```\n\nUnexpected failures are handled by the platform's generic 500 handler and don't include this body."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/public-key/is-key-exist":{"get":{"operationId":"IsKeyExist","tags":["Attestation public keys"],"summary":"Check whether a public key exists","description":"Check whether a public key with the specified name is registered.\n\nA key that was never registered returns `{ \"exists\": false }` with a `200` status. This is an answer, not an error.\n\n**Required role:** Any role with the Asset Inventory (`asset_management`) or CLI Tool (`ci_tool_view`) set to View.\n\n**Required license:** Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.","responses":{"200":{"description":"Whether or not the key exists.","content":{"application/json":{"schema":{"anyOf":[{"properties":{"exists":{"type":"boolean","description":"Whether a key with the specified name is registered."}},"required":["exists"],"type":"object"},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true},{"in":"query","name":"publicKeyName","required":true,"description":"Name of the public key to check.","schema":{"type":"string"}}]}}},"components":{"schemas":{"AttestationErrorResponse":{"description":"Response body returned for every expected error.","properties":{"errorMessage":{"type":"string","description":"Human-readable description of the error."},"errorStatus":{"$ref":"#/components/schemas/AttestationErrorStatus"}},"required":["errorMessage","errorStatus"],"type":"object","additionalProperties":false},"AttestationErrorStatus":{"description":"Error code that identifies the type of failure.\n- `PUBLIC_KEY_NOT_REGISTERED` (404): The named key doesn't exist.\n- `PUBLIC_KEY_ALREADY_REGISTERED` (409): You tried to add a key with a name that's already taken.\n- `UNSUPPORTED_PUBLIC_KEY_TYPE` (400): The supplied key isn't a supported type.\n- `INVALID_ROTATION_POLICY` (400): The rotation policy isn't valid.\n- `BAD_ROTATION_UPDATE` (400): The rotation change isn't allowed.\n- `INVALID_PRESIGNED_URL` (400): A supplied presigned URL is malformed or doesn't use HTTPS.\n- `INVALID_REQUEST_PARAMS`: The request parameters aren't valid.\n- `PIPELINE_NOT_FOUND` (404): The pipeline ID doesn't exist.\n- `NETWORK_ISSUE` (500): A downstream call failed.\n- `UNKNOWN_ERROR` (500): An unclassified failure occurred.","enum":["PUBLIC_KEY_NOT_REGISTERED","PUBLIC_KEY_ALREADY_REGISTERED","UNSUPPORTED_PUBLIC_KEY_TYPE","INVALID_ROTATION_POLICY","BAD_ROTATION_UPDATE","INVALID_PRESIGNED_URL","INVALID_REQUEST_PARAMS","PIPELINE_NOT_FOUND","NETWORK_ISSUE","UNKNOWN_ERROR"],"type":"string"},"BillingErrorResponse":{"type":"object","properties":{"reply":{"type":"object","properties":{"err_code":{"type":"integer","description":"The HTTP status code of the error."},"err_msg":{"type":"string","description":"A short description of the error type."},"err_extra":{"type":"string","description":"A detailed message explaining the cause of the error.","nullable":true}}}}}},"responses":{"Unauthorized":{"description":"Unauthorized - The request is unauthenticated. Pass the correct auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}},"Forbidden":{"description":"Forbidden - Access to the resource is prohibited. Try with different auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}}}}}
````

## Add a public key

> Register a new public key. The key material is validated and stored encrypted.\
> \
> The key owner is taken from the authenticated caller, so don't include it in the request body.\
> \
> The PEM must be JSON-escaped (real newlines become \`\n\`). To avoid escaping it manually, run the following command, and then pass \`-d @body.json\` in your request:\
> \
> \`\`\`bash\
> jq -Rs '{keyName:"my-cosign-key", publicKey:., rotation:{policyDays:90}}' < mykey.pub > body.json\
> \`\`\`\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\_action\`) or CLI Tool (\`ci\_tool\_edit\`) set to View/Edit.\
> \
> \*\*Required license:\*\* Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.

````json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex Cloud"},"tags":[{"name":"Attestation public keys","description":"Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.\n\n### Conventions\n\n- `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.\n- The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.\n- The update and delete endpoints return no body. A successful call returns `200` with an empty response.\n\n### Error format\n\nEvery expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:\n\n```json\n{\n  \"errorMessage\": \"human-readable description\",\n  \"errorStatus\": \"PUBLIC_KEY_NOT_REGISTERED\"\n}\n```\n\nUnexpected failures are handled by the platform's generic 500 handler and don't include this body."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/public-key/add":{"post":{"operationId":"addPublicKey","tags":["Attestation public keys"],"summary":"Add a public key","description":"Register a new public key. The key material is validated and stored encrypted.\n\nThe key owner is taken from the authenticated caller, so don't include it in the request body.\n\nThe PEM must be JSON-escaped (real newlines become `\\n`). To avoid escaping it manually, run the following command, and then pass `-d @body.json` in your request:\n\n```bash\njq -Rs '{keyName:\"my-cosign-key\", publicKey:., rotation:{policyDays:90}}' < mykey.pub > body.json\n```\n\n**Required role:** Any role with the Asset Inventory (`asset_management_action`) or CLI Tool (`ci_tool_edit`) set to View/Edit.\n\n**Required license:** Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.","responses":{"200":{"description":"The key is registered. The response contains the key metadata.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicKeyMetadata"},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"400":{"description":"Bad request. The key type isn't supported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"description":"Conflict. A key with this name is already registered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationErrorResponse"}}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true}],"requestBody":{"required":true,"description":"Public key to register.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddPublicKeyRequest"}}}}}}},"components":{"schemas":{"PublicKeyMetadata":{"description":"Metadata for a public key. This object never contains key material.","properties":{"keyName":{"type":"string","description":"Name the key is registered under."},"publicKeyFingerprint":{"type":"string","description":"Fingerprint of the key in `SHA256:<base64>` format. The backend derives the fingerprint from the DER-encoded SubjectPublicKeyInfo (SPKI)."},"rotation":{"$ref":"#/components/schemas/AttestationRotation"},"keyStatus":{"$ref":"#/components/schemas/AttestationKeyStatus","description":"Status of the key, derived at read time. When more than one status applies, the order of precedence is `deleted`, `expired`, `rotation-due`, `active`."},"createdAt":{"type":"number","format":"double","description":"Time the key was created, in epoch milliseconds."},"updatedAt":{"type":"number","format":"double","description":"Time the key was last updated, in epoch milliseconds."}},"required":["keyName","publicKeyFingerprint","rotation","keyStatus","createdAt","updatedAt"],"type":"object"},"AttestationRotation":{"description":"Key rotation settings.","properties":{"policyDays":{"type":"number","format":"double","description":"Rotation period, in days."},"nextRotationTS":{"type":"number","format":"double","description":"Time when the key is next due for rotation, in epoch milliseconds. The server computes this value from `policyDays`."}},"required":["policyDays","nextRotationTS"],"type":"object","additionalProperties":false},"AttestationKeyStatus":{"description":"Status of the key. The status is derived at read time and is never stored.\n- `active`: The key is healthy.\n- `rotation-due`: The key is within 7 days of `nextRotationTS`.\n- `expired`: The key is past `nextRotationTS`.\n- `deleted`: The key is soft-deleted. This value takes precedence over the rotation-based values.","enum":["active","rotation-due","expired","deleted"],"type":"string"},"AttestationErrorResponse":{"description":"Response body returned for every expected error.","properties":{"errorMessage":{"type":"string","description":"Human-readable description of the error."},"errorStatus":{"$ref":"#/components/schemas/AttestationErrorStatus"}},"required":["errorMessage","errorStatus"],"type":"object","additionalProperties":false},"AttestationErrorStatus":{"description":"Error code that identifies the type of failure.\n- `PUBLIC_KEY_NOT_REGISTERED` (404): The named key doesn't exist.\n- `PUBLIC_KEY_ALREADY_REGISTERED` (409): You tried to add a key with a name that's already taken.\n- `UNSUPPORTED_PUBLIC_KEY_TYPE` (400): The supplied key isn't a supported type.\n- `INVALID_ROTATION_POLICY` (400): The rotation policy isn't valid.\n- `BAD_ROTATION_UPDATE` (400): The rotation change isn't allowed.\n- `INVALID_PRESIGNED_URL` (400): A supplied presigned URL is malformed or doesn't use HTTPS.\n- `INVALID_REQUEST_PARAMS`: The request parameters aren't valid.\n- `PIPELINE_NOT_FOUND` (404): The pipeline ID doesn't exist.\n- `NETWORK_ISSUE` (500): A downstream call failed.\n- `UNKNOWN_ERROR` (500): An unclassified failure occurred.","enum":["PUBLIC_KEY_NOT_REGISTERED","PUBLIC_KEY_ALREADY_REGISTERED","UNSUPPORTED_PUBLIC_KEY_TYPE","INVALID_ROTATION_POLICY","BAD_ROTATION_UPDATE","INVALID_PRESIGNED_URL","INVALID_REQUEST_PARAMS","PIPELINE_NOT_FOUND","NETWORK_ISSUE","UNKNOWN_ERROR"],"type":"string"},"BillingErrorResponse":{"type":"object","properties":{"reply":{"type":"object","properties":{"err_code":{"type":"integer","description":"The HTTP status code of the error."},"err_msg":{"type":"string","description":"A short description of the error type."},"err_extra":{"type":"string","description":"A detailed message explaining the cause of the error.","nullable":true}}}}},"AddPublicKeyRequest":{"properties":{"keyName":{"type":"string","description":"Unique name for the key."},"publicKey":{"type":"string","description":"PEM-encoded public key. The PEM must be JSON-escaped (real newlines become `\\n`)."},"rotation":{"$ref":"#/components/schemas/AttestationRotationInput"}},"required":["keyName","publicKey","rotation"],"type":"object","description":"Request body for adding a public key. The key owner is taken from the authenticated caller, so don't include it in the body."},"AttestationRotationInput":{"description":"Rotation settings to apply to the key.","properties":{"policyDays":{"type":"number","format":"double","description":"Rotation period, in days. The server computes `nextRotationTS` from this value."}},"required":["policyDays"],"type":"object","additionalProperties":false}},"responses":{"Unauthorized":{"description":"Unauthorized - The request is unauthenticated. Pass the correct auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}},"Forbidden":{"description":"Forbidden - Access to the resource is prohibited. Try with different auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}}}}}
````

## List public keys

> Get the metadata for all registered public keys. The response doesn't include key material.\
> \
> A tenant with no keys returns an empty array (\`\[]\`).\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\`) or CLI Tool (\`ci\_tool\_view\`) set to View.\
> \
> \*\*Required license:\*\* Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.

````json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex Cloud"},"tags":[{"name":"Attestation public keys","description":"Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.\n\n### Conventions\n\n- `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.\n- The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.\n- The update and delete endpoints return no body. A successful call returns `200` with an empty response.\n\n### Error format\n\nEvery expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:\n\n```json\n{\n  \"errorMessage\": \"human-readable description\",\n  \"errorStatus\": \"PUBLIC_KEY_NOT_REGISTERED\"\n}\n```\n\nUnexpected failures are handled by the platform's generic 500 handler and don't include this body."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/public-key/list":{"get":{"operationId":"listPublicKeys","tags":["Attestation public keys"],"summary":"List public keys","description":"Get the metadata for all registered public keys. The response doesn't include key material.\n\nA tenant with no keys returns an empty array (`[]`).\n\n**Required role:** Any role with the Asset Inventory (`asset_management`) or CLI Tool (`ci_tool_view`) set to View.\n\n**Required license:** Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.","responses":{"200":{"description":"Metadata for all registered keys.","content":{"application/json":{"schema":{"anyOf":[{"items":{"$ref":"#/components/schemas/PublicKeyMetadata"},"type":"array"},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true}]}}},"components":{"schemas":{"PublicKeyMetadata":{"description":"Metadata for a public key. This object never contains key material.","properties":{"keyName":{"type":"string","description":"Name the key is registered under."},"publicKeyFingerprint":{"type":"string","description":"Fingerprint of the key in `SHA256:<base64>` format. The backend derives the fingerprint from the DER-encoded SubjectPublicKeyInfo (SPKI)."},"rotation":{"$ref":"#/components/schemas/AttestationRotation"},"keyStatus":{"$ref":"#/components/schemas/AttestationKeyStatus","description":"Status of the key, derived at read time. When more than one status applies, the order of precedence is `deleted`, `expired`, `rotation-due`, `active`."},"createdAt":{"type":"number","format":"double","description":"Time the key was created, in epoch milliseconds."},"updatedAt":{"type":"number","format":"double","description":"Time the key was last updated, in epoch milliseconds."}},"required":["keyName","publicKeyFingerprint","rotation","keyStatus","createdAt","updatedAt"],"type":"object"},"AttestationRotation":{"description":"Key rotation settings.","properties":{"policyDays":{"type":"number","format":"double","description":"Rotation period, in days."},"nextRotationTS":{"type":"number","format":"double","description":"Time when the key is next due for rotation, in epoch milliseconds. The server computes this value from `policyDays`."}},"required":["policyDays","nextRotationTS"],"type":"object","additionalProperties":false},"AttestationKeyStatus":{"description":"Status of the key. The status is derived at read time and is never stored.\n- `active`: The key is healthy.\n- `rotation-due`: The key is within 7 days of `nextRotationTS`.\n- `expired`: The key is past `nextRotationTS`.\n- `deleted`: The key is soft-deleted. This value takes precedence over the rotation-based values.","enum":["active","rotation-due","expired","deleted"],"type":"string"},"AttestationErrorResponse":{"description":"Response body returned for every expected error.","properties":{"errorMessage":{"type":"string","description":"Human-readable description of the error."},"errorStatus":{"$ref":"#/components/schemas/AttestationErrorStatus"}},"required":["errorMessage","errorStatus"],"type":"object","additionalProperties":false},"AttestationErrorStatus":{"description":"Error code that identifies the type of failure.\n- `PUBLIC_KEY_NOT_REGISTERED` (404): The named key doesn't exist.\n- `PUBLIC_KEY_ALREADY_REGISTERED` (409): You tried to add a key with a name that's already taken.\n- `UNSUPPORTED_PUBLIC_KEY_TYPE` (400): The supplied key isn't a supported type.\n- `INVALID_ROTATION_POLICY` (400): The rotation policy isn't valid.\n- `BAD_ROTATION_UPDATE` (400): The rotation change isn't allowed.\n- `INVALID_PRESIGNED_URL` (400): A supplied presigned URL is malformed or doesn't use HTTPS.\n- `INVALID_REQUEST_PARAMS`: The request parameters aren't valid.\n- `PIPELINE_NOT_FOUND` (404): The pipeline ID doesn't exist.\n- `NETWORK_ISSUE` (500): A downstream call failed.\n- `UNKNOWN_ERROR` (500): An unclassified failure occurred.","enum":["PUBLIC_KEY_NOT_REGISTERED","PUBLIC_KEY_ALREADY_REGISTERED","UNSUPPORTED_PUBLIC_KEY_TYPE","INVALID_ROTATION_POLICY","BAD_ROTATION_UPDATE","INVALID_PRESIGNED_URL","INVALID_REQUEST_PARAMS","PIPELINE_NOT_FOUND","NETWORK_ISSUE","UNKNOWN_ERROR"],"type":"string"},"BillingErrorResponse":{"type":"object","properties":{"reply":{"type":"object","properties":{"err_code":{"type":"integer","description":"The HTTP status code of the error."},"err_msg":{"type":"string","description":"A short description of the error type."},"err_extra":{"type":"string","description":"A detailed message explaining the cause of the error.","nullable":true}}}}}},"responses":{"Unauthorized":{"description":"Unauthorized - The request is unauthenticated. Pass the correct auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}},"Forbidden":{"description":"Forbidden - Access to the resource is prohibited. Try with different auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}}}}}
````

## Get a public key

> Get the metadata and key material for a single public key. This is the only endpoint that returns the key material.\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\`) or CLI Tool (\`ci\_tool\_view\`) set to View.\
> \
> \*\*Required license:\*\* Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.

````json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex Cloud"},"tags":[{"name":"Attestation public keys","description":"Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.\n\n### Conventions\n\n- `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.\n- The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.\n- The update and delete endpoints return no body. A successful call returns `200` with an empty response.\n\n### Error format\n\nEvery expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:\n\n```json\n{\n  \"errorMessage\": \"human-readable description\",\n  \"errorStatus\": \"PUBLIC_KEY_NOT_REGISTERED\"\n}\n```\n\nUnexpected failures are handled by the platform's generic 500 handler and don't include this body."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/public-key/get":{"get":{"operationId":"getPublicKey","tags":["Attestation public keys"],"summary":"Get a public key","description":"Get the metadata and key material for a single public key. This is the only endpoint that returns the key material.\n\n**Required role:** Any role with the Asset Inventory (`asset_management`) or CLI Tool (`ci_tool_view`) set to View.\n\n**Required license:** Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.","responses":{"200":{"description":"The key metadata and key material.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PublicKeyWithMaterial"},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Not found. The key isn't registered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationErrorResponse"}}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true},{"in":"query","name":"publicKeyName","required":true,"description":"Name of the public key to get.","schema":{"type":"string"}}]}}},"components":{"schemas":{"PublicKeyWithMaterial":{"description":"Metadata for a public key, plus the key material. Only the get endpoint returns this object.","allOf":[{"$ref":"#/components/schemas/PublicKeyMetadata"},{"type":"object","properties":{"publicKey":{"type":"string","description":"PEM-encoded public key material."}},"required":["publicKey"]}]},"PublicKeyMetadata":{"description":"Metadata for a public key. This object never contains key material.","properties":{"keyName":{"type":"string","description":"Name the key is registered under."},"publicKeyFingerprint":{"type":"string","description":"Fingerprint of the key in `SHA256:<base64>` format. The backend derives the fingerprint from the DER-encoded SubjectPublicKeyInfo (SPKI)."},"rotation":{"$ref":"#/components/schemas/AttestationRotation"},"keyStatus":{"$ref":"#/components/schemas/AttestationKeyStatus","description":"Status of the key, derived at read time. When more than one status applies, the order of precedence is `deleted`, `expired`, `rotation-due`, `active`."},"createdAt":{"type":"number","format":"double","description":"Time the key was created, in epoch milliseconds."},"updatedAt":{"type":"number","format":"double","description":"Time the key was last updated, in epoch milliseconds."}},"required":["keyName","publicKeyFingerprint","rotation","keyStatus","createdAt","updatedAt"],"type":"object"},"AttestationRotation":{"description":"Key rotation settings.","properties":{"policyDays":{"type":"number","format":"double","description":"Rotation period, in days."},"nextRotationTS":{"type":"number","format":"double","description":"Time when the key is next due for rotation, in epoch milliseconds. The server computes this value from `policyDays`."}},"required":["policyDays","nextRotationTS"],"type":"object","additionalProperties":false},"AttestationKeyStatus":{"description":"Status of the key. The status is derived at read time and is never stored.\n- `active`: The key is healthy.\n- `rotation-due`: The key is within 7 days of `nextRotationTS`.\n- `expired`: The key is past `nextRotationTS`.\n- `deleted`: The key is soft-deleted. This value takes precedence over the rotation-based values.","enum":["active","rotation-due","expired","deleted"],"type":"string"},"AttestationErrorResponse":{"description":"Response body returned for every expected error.","properties":{"errorMessage":{"type":"string","description":"Human-readable description of the error."},"errorStatus":{"$ref":"#/components/schemas/AttestationErrorStatus"}},"required":["errorMessage","errorStatus"],"type":"object","additionalProperties":false},"AttestationErrorStatus":{"description":"Error code that identifies the type of failure.\n- `PUBLIC_KEY_NOT_REGISTERED` (404): The named key doesn't exist.\n- `PUBLIC_KEY_ALREADY_REGISTERED` (409): You tried to add a key with a name that's already taken.\n- `UNSUPPORTED_PUBLIC_KEY_TYPE` (400): The supplied key isn't a supported type.\n- `INVALID_ROTATION_POLICY` (400): The rotation policy isn't valid.\n- `BAD_ROTATION_UPDATE` (400): The rotation change isn't allowed.\n- `INVALID_PRESIGNED_URL` (400): A supplied presigned URL is malformed or doesn't use HTTPS.\n- `INVALID_REQUEST_PARAMS`: The request parameters aren't valid.\n- `PIPELINE_NOT_FOUND` (404): The pipeline ID doesn't exist.\n- `NETWORK_ISSUE` (500): A downstream call failed.\n- `UNKNOWN_ERROR` (500): An unclassified failure occurred.","enum":["PUBLIC_KEY_NOT_REGISTERED","PUBLIC_KEY_ALREADY_REGISTERED","UNSUPPORTED_PUBLIC_KEY_TYPE","INVALID_ROTATION_POLICY","BAD_ROTATION_UPDATE","INVALID_PRESIGNED_URL","INVALID_REQUEST_PARAMS","PIPELINE_NOT_FOUND","NETWORK_ISSUE","UNKNOWN_ERROR"],"type":"string"},"BillingErrorResponse":{"type":"object","properties":{"reply":{"type":"object","properties":{"err_code":{"type":"integer","description":"The HTTP status code of the error."},"err_msg":{"type":"string","description":"A short description of the error type."},"err_extra":{"type":"string","description":"A detailed message explaining the cause of the error.","nullable":true}}}}}},"responses":{"Unauthorized":{"description":"Unauthorized - The request is unauthenticated. Pass the correct auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}},"Forbidden":{"description":"Forbidden - Access to the resource is prohibited. Try with different auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}}}}}
````

## Update a public key

> Update the key material or rotation period of a registered public key. Specify the key name in the query string and the changes in the request body. Both body fields are optional, so send only the fields you want to change.\
> \
> A successful call returns \`200\` with an empty body. To confirm the change, get the key.\
> \
> To print only the status code, run:\
> \
> \`\`\`bash\
> curl -o /dev/null -w '%{http\_code}\n' -X POST "$BASE/public-key/update?publicKeyName=my-cosign-key" \\\
> &#x20; -H "Authorization: $CORTEX\_API\_KEY" \\\
> &#x20; -H "x-xdr-auth-id: $CORTEX\_API\_KEY\_ID" \\\
> &#x20; -H "Content-Type: application/json" \\\
> &#x20; -d '{ "rotation": { "policyDays": 30 } }'\
> \`\`\`\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\_action\`) or CLI Tool (\`ci\_tool\_edit\`) set to View/Edit.\
> \
> \*\*Required license:\*\* Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.

````json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex Cloud"},"tags":[{"name":"Attestation public keys","description":"Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.\n\n### Conventions\n\n- `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.\n- The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.\n- The update and delete endpoints return no body. A successful call returns `200` with an empty response.\n\n### Error format\n\nEvery expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:\n\n```json\n{\n  \"errorMessage\": \"human-readable description\",\n  \"errorStatus\": \"PUBLIC_KEY_NOT_REGISTERED\"\n}\n```\n\nUnexpected failures are handled by the platform's generic 500 handler and don't include this body."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/public-key/update":{"post":{"operationId":"updatePublicKey","tags":["Attestation public keys"],"summary":"Update a public key","description":"Update the key material or rotation period of a registered public key. Specify the key name in the query string and the changes in the request body. Both body fields are optional, so send only the fields you want to change.\n\nA successful call returns `200` with an empty body. To confirm the change, get the key.\n\nTo print only the status code, run:\n\n```bash\ncurl -o /dev/null -w '%{http_code}\\n' -X POST \"$BASE/public-key/update?publicKeyName=my-cosign-key\" \\\n  -H \"Authorization: $CORTEX_API_KEY\" \\\n  -H \"x-xdr-auth-id: $CORTEX_API_KEY_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ \"rotation\": { \"policyDays\": 30 } }'\n```\n\n**Required role:** Any role with the Asset Inventory (`asset_management_action`) or CLI Tool (`ci_tool_edit`) set to View/Edit.\n\n**Required license:** Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.","responses":{"200":{"description":"The key is updated. The response body is empty.","content":{"application/json":{"schema":{"anyOf":[{},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"400":{"description":"Bad request. The replacement key isn't supported.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Not found. The key isn't registered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationErrorResponse"}}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true},{"in":"query","name":"publicKeyName","required":true,"description":"Name of the public key to update.","schema":{"type":"string"}}],"requestBody":{"required":true,"description":"Changes to apply to the key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePublicKeyRequest"}}}}}}},"components":{"schemas":{"AttestationErrorResponse":{"description":"Response body returned for every expected error.","properties":{"errorMessage":{"type":"string","description":"Human-readable description of the error."},"errorStatus":{"$ref":"#/components/schemas/AttestationErrorStatus"}},"required":["errorMessage","errorStatus"],"type":"object","additionalProperties":false},"AttestationErrorStatus":{"description":"Error code that identifies the type of failure.\n- `PUBLIC_KEY_NOT_REGISTERED` (404): The named key doesn't exist.\n- `PUBLIC_KEY_ALREADY_REGISTERED` (409): You tried to add a key with a name that's already taken.\n- `UNSUPPORTED_PUBLIC_KEY_TYPE` (400): The supplied key isn't a supported type.\n- `INVALID_ROTATION_POLICY` (400): The rotation policy isn't valid.\n- `BAD_ROTATION_UPDATE` (400): The rotation change isn't allowed.\n- `INVALID_PRESIGNED_URL` (400): A supplied presigned URL is malformed or doesn't use HTTPS.\n- `INVALID_REQUEST_PARAMS`: The request parameters aren't valid.\n- `PIPELINE_NOT_FOUND` (404): The pipeline ID doesn't exist.\n- `NETWORK_ISSUE` (500): A downstream call failed.\n- `UNKNOWN_ERROR` (500): An unclassified failure occurred.","enum":["PUBLIC_KEY_NOT_REGISTERED","PUBLIC_KEY_ALREADY_REGISTERED","UNSUPPORTED_PUBLIC_KEY_TYPE","INVALID_ROTATION_POLICY","BAD_ROTATION_UPDATE","INVALID_PRESIGNED_URL","INVALID_REQUEST_PARAMS","PIPELINE_NOT_FOUND","NETWORK_ISSUE","UNKNOWN_ERROR"],"type":"string"},"BillingErrorResponse":{"type":"object","properties":{"reply":{"type":"object","properties":{"err_code":{"type":"integer","description":"The HTTP status code of the error."},"err_msg":{"type":"string","description":"A short description of the error type."},"err_extra":{"type":"string","description":"A detailed message explaining the cause of the error.","nullable":true}}}}},"UpdatePublicKeyRequest":{"description":"Request body for updating a public key. Both fields are optional, so send only the fields you want to change.","properties":{"publicKey":{"type":"string","description":"Replacement PEM-encoded public key."},"rotation":{"$ref":"#/components/schemas/AttestationRotationInput"}},"type":"object","additionalProperties":false},"AttestationRotationInput":{"description":"Rotation settings to apply to the key.","properties":{"policyDays":{"type":"number","format":"double","description":"Rotation period, in days. The server computes `nextRotationTS` from this value."}},"required":["policyDays"],"type":"object","additionalProperties":false}},"responses":{"Unauthorized":{"description":"Unauthorized - The request is unauthenticated. Pass the correct auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}},"Forbidden":{"description":"Forbidden - Access to the resource is prohibited. Try with different auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}}}}}
````

## Delete a public key

> Soft-delete a public key. The key status changes to \`deleted\`.\
> \
> A successful call returns \`200\` with an empty body.\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\_action\`) or CLI Tool (\`ci\_tool\_edit\`) set to View/Edit.\
> \
> \*\*Required license:\*\* Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.

````json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex Cloud"},"tags":[{"name":"Attestation public keys","description":"Use the Attestation API to manage the public keys that verify signed CI/CD artifacts (cosign attestations). Register, list, read, update, and delete keys, and validate a key before you register it.\n\n### Conventions\n\n- `publicKeyName` is always a query parameter, including on the update endpoint, which also takes a request body.\n- The delete endpoint uses the `DELETE` method. The update endpoint uses `POST`, not `PUT` or `PATCH`.\n- The update and delete endpoints return no body. A successful call returns `200` with an empty response.\n\n### Error format\n\nEvery expected error returns the same two-field body, with the HTTP status set according to the `errorStatus` value:\n\n```json\n{\n  \"errorMessage\": \"human-readable description\",\n  \"errorStatus\": \"PUBLIC_KEY_NOT_REGISTERED\"\n}\n```\n\nUnexpected failures are handled by the platform's generic 500 handler and don't include this body."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/public-key/delete":{"delete":{"operationId":"deletePublicKey","tags":["Attestation public keys"],"summary":"Delete a public key","description":"Soft-delete a public key. The key status changes to `deleted`.\n\nA successful call returns `200` with an empty body.\n\n**Required role:** Any role with the Asset Inventory (`asset_management_action`) or CLI Tool (`ci_tool_edit`) set to View/Edit.\n\n**Required license:** Cortex Cloud Posture Management or Cortex Cloud Runtime Security, together with the Application Security add-on.","responses":{"200":{"description":"The key is deleted. The response body is empty.","content":{"application/json":{"schema":{"anyOf":[{},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Not found. The key isn't registered or is already deleted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationErrorResponse"}}}}},"parameters":[{"schema":{"type":"string"},"in":"header","name":"Authorization","description":"{api_key}","required":true},{"schema":{"type":"string"},"in":"header","name":"x-xdr-auth-id","description":"{api_key_id}","required":true},{"in":"query","name":"publicKeyName","required":true,"description":"Name of the public key to delete.","schema":{"type":"string"}}]}}},"components":{"schemas":{"AttestationErrorResponse":{"description":"Response body returned for every expected error.","properties":{"errorMessage":{"type":"string","description":"Human-readable description of the error."},"errorStatus":{"$ref":"#/components/schemas/AttestationErrorStatus"}},"required":["errorMessage","errorStatus"],"type":"object","additionalProperties":false},"AttestationErrorStatus":{"description":"Error code that identifies the type of failure.\n- `PUBLIC_KEY_NOT_REGISTERED` (404): The named key doesn't exist.\n- `PUBLIC_KEY_ALREADY_REGISTERED` (409): You tried to add a key with a name that's already taken.\n- `UNSUPPORTED_PUBLIC_KEY_TYPE` (400): The supplied key isn't a supported type.\n- `INVALID_ROTATION_POLICY` (400): The rotation policy isn't valid.\n- `BAD_ROTATION_UPDATE` (400): The rotation change isn't allowed.\n- `INVALID_PRESIGNED_URL` (400): A supplied presigned URL is malformed or doesn't use HTTPS.\n- `INVALID_REQUEST_PARAMS`: The request parameters aren't valid.\n- `PIPELINE_NOT_FOUND` (404): The pipeline ID doesn't exist.\n- `NETWORK_ISSUE` (500): A downstream call failed.\n- `UNKNOWN_ERROR` (500): An unclassified failure occurred.","enum":["PUBLIC_KEY_NOT_REGISTERED","PUBLIC_KEY_ALREADY_REGISTERED","UNSUPPORTED_PUBLIC_KEY_TYPE","INVALID_ROTATION_POLICY","BAD_ROTATION_UPDATE","INVALID_PRESIGNED_URL","INVALID_REQUEST_PARAMS","PIPELINE_NOT_FOUND","NETWORK_ISSUE","UNKNOWN_ERROR"],"type":"string"},"BillingErrorResponse":{"type":"object","properties":{"reply":{"type":"object","properties":{"err_code":{"type":"integer","description":"The HTTP status code of the error."},"err_msg":{"type":"string","description":"A short description of the error type."},"err_extra":{"type":"string","description":"A detailed message explaining the cause of the error.","nullable":true}}}}}},"responses":{"Unauthorized":{"description":"Unauthorized - The request is unauthenticated. Pass the correct auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}},"Forbidden":{"description":"Forbidden - Access to the resource is prohibited. Try with different auth credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingErrorResponse"}}}}}}}
````


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://cortex-docs.paloaltonetworks.com/cortex-cloud-api/aspm-cicd-and-application-security/attestation-public-keys.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
