---
title: "Bind Credential"
method: POST
path: "/agents/{agent_id}/credentials"
tags: ["Agents"]
---

# Bind Credential

`POST /agents/{agent_id}/credentials`

Directly bind a credential to an agent (theme 5 phase 1).

The caller must own the target credential (or hold ``org:admin``); a
credential that does not exist or that the caller does not own returns 404.

## Path parameters

- `agent_id` string, required

## Request body

- CredentialBindRequest — Request body for directly binding a credential to an agent.
  - `credential_id` string, required

## Response `201`

Successful Response

- CredentialBindingResponse — Direct agent↔credential binding representation in API responses.
  - `agent_id` string, required
  - `bound_at` string, date-time, required
  - `credential_id` string, required
  - `id` string, required
  - `name` string, nullable
  - `rule_set_id` string, nullable
  - `serves` ServedApiRef[]
    - `api_name` string, nullable
    - `api_vendor` string, required
    - `api_version` string, nullable
  - `suspended` boolean, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `503` — Service Unavailable

## Changes

- **2026-09-14** `d56864df177c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/jentic/apis/jentic-control-plane-api/changes/agents/:agent_id/credentials/post.md)

---

[API](https://skmtc.dev/jentic/apis/jentic-control-plane-api.md) · [All operations](https://skmtc.dev/jentic/apis/jentic-control-plane-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jentic/apis/jentic-control-plane-api/revisions/e4688b93dfc7?raw)