ArgorantDocs

Rename a folder

patchhttps://app.argorant.com/api/v1/folders/{folder_id}
PATCH
/api/v1/folders/{folder_id}

The new name.

Gives a folder a new name. Its campaigns stay in it.

CostWhat it doesKey scopes
FreeWritesargorant:manage_lists

Authorization

BearerAuth
AuthorizationBearer <token>

Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.

In: header

Path Parameters

folder_id*string

The folder id from GET /api/v1/folders.

Formatuuid

Header Parameters

Idempotency-Key?string

Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.

Lengthlength <= 128
X-Request-Id?string

Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.

Match^[A-Za-z0-9._-]{8,64}$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Shell
curl -X PATCH "https://app.argorant.com/api/v1/folders/9d8c7b6a-5e4f-4a3b-8c2d-1e0f9a8b7c6d" \  -H "Idempotency-Key: 6f1c2e7a-run-42" \  -H "Content-Type: application/json" \  -d '{    "name": "Q4 outreach DACH"  }'
JSON
{  "folder": {    "id": "9d8c7b6a-5e4f-4a3b-8c2d-1e0f9a8b7c6d",    "name": "Q4 outreach DACH",    "campaigns": 3,    "created_at": "2026-10-19T09:00:00+00:00"  }}