> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bind Asset - POST /v1/workspaces/:workspace_id/agents/:agent_id/bindings

> Bind an asset to an Agent Loadout via POST /v1/workspaces/:workspace_id/agents/:agent_id/bindings. Minimum role contributor.

Bind an asset (KB / memory cube / wiki / skill / chat memory / code graph) to an Agent Loadout, with a priority and usage mode.

## Endpoint

```http theme={null}
POST /v1/workspaces/:workspace_id/agents/:agent_id/bindings
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>`. Minimum role: **contributor**.

## Path parameters

**workspace\_id** `string` *required*

Workspace id.

**agent\_id** `string` *required*

Agent id.

## Request body

**asset\_type** `string` *required*

Asset type: `kb` / `cube` / `wiki` / `skill` / `chat_memory` / `codegraph`.

**asset\_id** `string` *required*

Asset id.

**priority** `integer`

Priority (higher wins).

**usage\_mode** `string`

Usage mode: `bootstrap` (loaded at start) / `on_demand` (called when needed).

## Response

**id** `string`

Binding id (`bind_...`).

**agent\_id** `string`

Owning agent id.

**asset\_type** `string`

Asset type.

**asset\_id** `string`

Asset id.

**priority** `integer`

Priority.

**usage\_mode** `string`

Usage mode.

**created\_at** `string`

Creation time (RFC3339).

## Example

```bash cURL theme={null}
curl -X POST https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/agents/agent_01a2b3c4d5e6/bindings \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"asset_type":"kb","asset_id":"kb_01a2b3c4d5e6","priority":10,"usage_mode":"bootstrap"}'
```

```json 200 theme={null}
{
  "id": "bind_01a2b3c4d5e6",
  "agent_id": "agent_01a2b3c4d5e6",
  "asset_type": "kb",
  "asset_id": "kb_01a2b3c4d5e6",
  "priority": 10,
  "usage_mode": "bootstrap",
  "created_at": "2026-10-12T12:05:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.