---
title: "Attach Revision Secret"
method: POST
path: "/v2/agents/{agentId}/revisions/{buildId}/credentials"
tags: ["Secrets"]
---

# Attach Revision Secret

`POST /v2/agents/{agentId}/revisions/{buildId}/credentials`

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/agents/{agentId}/revisions/{buildId}/credentials`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/agents/:agentId/revisions/:buildId/credentials/post.ts> (a function with typed inputs; its response is checked against the schema)

Attach an env-var secret to a revision so its keys are injected into Runs spawned from that revision. Personal secrets can only be attached by their owner; team-shared secrets require builder permissions.

## Path parameters

- `agentId` string, uuid, required
- `buildId` string, uuid, required

## Request body

- object
  - `credentialId` string, uuid, required

## Response `201`

Default Response

- object
  - `success` boolean, required

## Other responses

- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `409`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)