> 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/xdr-api/aspm-cicd-and-application-security/attestation-pipelines.md).

# Attestation Pipelines

Run read-only lookups over pipeline signing data. Find out which pipelines perform artifact signing and which public keys verify a given pipeline.

## List pipelines that perform signing

> Get the IDs of the pipelines that perform artifact signing. This endpoint tells you which pipelines sign, not what the signing outcome was. The response has no status field, and the request has no filter parameter.\
> \
> Results are ordered by \`pipelineId\`, which is unique and never changes. This keeps paging with \`limit\` and \`offset\` stable, so pages don't overlap or drop rows.\
> \
> A tenant with no signing pipelines returns \`{ "hasNext": false, "pipelines": \[] }\`.\
> \
> \*\*Required role:\*\* Any role with the Asset Inventory (\`asset\_management\`) or CLI Tool (\`ci\_tool\_view\`) set to View.\
> \
> \*\*Required license:\*\* Cortex XDR Pro per Endpoint with either the Cortex XDR Cloud Posture add-on or the Cortex Cloud Runtime Security add-on, together with the Cortex XDR Application Security add-on. Not available for Cortex XDR Prevent or Cortex XDR Pro per GB.

```json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex XDR 6.0"},"tags":[{"name":"Attestation pipelines","description":"Run read-only lookups over pipeline signing data. Find out which pipelines perform artifact signing and which public keys verify a given pipeline."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/pipelines-with-signing":{"post":{"operationId":"PipelinesWithSigning","tags":["Attestation pipelines"],"summary":"List pipelines that perform signing","description":"Get the IDs of the pipelines that perform artifact signing. This endpoint tells you which pipelines sign, not what the signing outcome was. The response has no status field, and the request has no filter parameter.\n\nResults are ordered by `pipelineId`, which is unique and never changes. This keeps paging with `limit` and `offset` stable, so pages don't overlap or drop rows.\n\nA tenant with no signing pipelines returns `{ \"hasNext\": false, \"pipelines\": [] }`.\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 XDR Pro per Endpoint with either the Cortex XDR Cloud Posture add-on or the Cortex Cloud Runtime Security add-on, together with the Cortex XDR Application Security add-on. Not available for Cortex XDR Prevent or Cortex XDR Pro per GB.","responses":{"200":{"description":"A page of pipelines that perform signing.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/PipelinesWithSigningPage"},{"$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":"Paging values. Send `{}` to accept the defaults.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PipelinesWithSigningBody"}}}}}}},"components":{"schemas":{"PipelinesWithSigningPage":{"description":"Page of pipelines that perform artifact signing.","properties":{"hasNext":{"type":"boolean","description":"Whether more results are available."},"nextPage":{"$ref":"#/components/schemas/AttestationPageRef"},"pipelines":{"items":{"$ref":"#/components/schemas/PipelineWithSigningRow"},"type":"array","description":"Pipelines that perform artifact signing, ordered by `pipelineId`. An empty array means that no pipelines in the tenant perform signing."}},"required":["hasNext","pipelines"],"type":"object","additionalProperties":false},"AttestationPageRef":{"description":"Paging values to use to request the next page.","properties":{"limit":{"type":"number","format":"double","description":"Maximum number of rows to return in the next page."},"offset":{"type":"number","format":"double","description":"Number of rows to skip to reach the next page."}},"required":["limit","offset"],"type":"object","additionalProperties":false},"PipelineWithSigningRow":{"description":"Pipeline that performs artifact signing.","properties":{"pipelineId":{"type":"string","description":"Asset ID of the pipeline. Pipeline IDs are opaque, case-sensitive, 64-character hex strings."},"pipelineName":{"type":"string","description":"Name of the pipeline."},"provider":{"type":"string","description":"CI/CD provider that runs the pipeline."},"repositoryName":{"type":"string","description":"Name of the repository that contains the pipeline."},"filePath":{"type":"string","description":"Path of the pipeline definition file in the repository. This field is absent for assets that don't have a file."}},"required":["pipelineId","pipelineName","provider"],"type":"object"},"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}}}}},"PipelinesWithSigningBody":{"description":"Request body for listing pipelines that perform signing. Both fields are optional. Send `{}` to accept the defaults.","properties":{"limit":{"type":"number","format":"double","description":"Maximum number of rows to return. Default: `50`."},"offset":{"type":"number","format":"double","description":"Number of rows to skip, for paging. Default: `0`."}},"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 keys that verify a pipeline

> Get the names of the public keys that verify a pipeline. The response never includes key material.\
> \
> Pipeline IDs are opaque, case-sensitive, 64-character hex strings, not \`org/repo/workflow\` names. To get valid IDs, list the pipelines that perform signing.\
> \
> A pipeline that exists but has never been signed returns a result with an empty \`keys\` array and a \`200\` status. This is a valid 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 XDR Pro per Endpoint with either the Cortex XDR Cloud Posture add-on or the Cortex Cloud Runtime Security add-on, together with the Cortex XDR Application Security add-on. Not available for Cortex XDR Prevent or Cortex XDR Pro per GB.

```json
{"openapi":"3.0.0","info":{"title":"ASPM, CICD and Application Security APIs","version":"Cortex XDR 6.0"},"tags":[{"name":"Attestation pipelines","description":"Run read-only lookups over pipeline signing data. Find out which pipelines perform artifact signing and which public keys verify a given pipeline."}],"servers":[{"url":"https://api-yourfqdn"}],"security":[],"paths":{"/public_api/appsec/v1/attestation/verify-keys-for-pipeline":{"post":{"operationId":"VerifyKeysForPipeline","tags":["Attestation pipelines"],"summary":"List keys that verify a pipeline","description":"Get the names of the public keys that verify a pipeline. The response never includes key material.\n\nPipeline IDs are opaque, case-sensitive, 64-character hex strings, not `org/repo/workflow` names. To get valid IDs, list the pipelines that perform signing.\n\nA pipeline that exists but has never been signed returns a result with an empty `keys` array and a `200` status. This is a valid 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 XDR Pro per Endpoint with either the Cortex XDR Cloud Posture add-on or the Cortex Cloud Runtime Security add-on, together with the Cortex XDR Application Security add-on. Not available for Cortex XDR Prevent or Cortex XDR Pro per GB.","responses":{"200":{"description":"The keys that verify the pipeline.","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/VerifyKeysForPipelinesResult"},{"$ref":"#/components/schemas/AttestationErrorResponse"}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"description":"Not found. The pipeline doesn't exist.","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":"Pipeline to look up.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyKeysForPipelineBody"}}}}}}},"components":{"schemas":{"VerifyKeysForPipelinesResult":{"description":"Public keys that verify each requested pipeline.","properties":{"results":{"items":{"$ref":"#/components/schemas/PipelineVerificationKeys"},"type":"array","description":"Matching pipelines and the keys that verify each one."},"truncated":{"type":"boolean","description":"Whether the result cap was reached. If `true`, narrow your search."}},"required":["results","truncated"],"type":"object","additionalProperties":false},"PipelineVerificationKeys":{"description":"Pipeline and the public keys that verify it.","allOf":[{"$ref":"#/components/schemas/PipelineWithSigningRow"},{"type":"object","properties":{"keys":{"items":{"$ref":"#/components/schemas/VerifyKeyForPipeline"},"type":"array","description":"Public keys that verify the pipeline. An empty array means that the pipeline exists but has never been signed."}},"required":["keys"]}]},"PipelineWithSigningRow":{"description":"Pipeline that performs artifact signing.","properties":{"pipelineId":{"type":"string","description":"Asset ID of the pipeline. Pipeline IDs are opaque, case-sensitive, 64-character hex strings."},"pipelineName":{"type":"string","description":"Name of the pipeline."},"provider":{"type":"string","description":"CI/CD provider that runs the pipeline."},"repositoryName":{"type":"string","description":"Name of the repository that contains the pipeline."},"filePath":{"type":"string","description":"Path of the pipeline definition file in the repository. This field is absent for assets that don't have a file."}},"required":["pipelineId","pipelineName","provider"],"type":"object"},"VerifyKeyForPipeline":{"description":"Public key that verifies a pipeline.","properties":{"keyName":{"type":"string","description":"Name of the public key. The response never includes key material."}},"required":["keyName"],"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}}}}},"VerifyKeysForPipelineBody":{"description":"Request body for listing the keys that verify a pipeline.","properties":{"pipelines":{"items":{"type":"string"},"type":"array","description":"Pipelines to look up. Each entry is a 64-character hex asset ID or a name fragment. You can send up to 10 entries per call. To get valid IDs, use the pipelines-with-signing endpoint."}},"required":["pipelines"],"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"}}}}}}}
```


---

# 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/xdr-api/aspm-cicd-and-application-security/attestation-pipelines.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.
