Agent SwarmAgent Swarm

KV

Namespaced key-value store API — read, write, delete, list, and atomically increment KV entries for cross-task agent state

GET
/api/kv

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

prefix?string
limit?integer
Range0 < value <= 1000
offset?|
Range0 <= value

Response Body

curl -X GET "http://localhost:3013/api/kv"
Empty
Empty
GET
/api/kv/_/{namespace}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

namespace*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Query Parameters

prefix?string
limit?integer
Range0 < value <= 1000
offset?|
Range0 <= value

Response Body

curl -X GET "http://localhost:3013/api/kv/_/string"
Empty
Empty
DELETE
/api/kv/_/{namespace}/{key}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

namespace*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512
key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Response Body

curl -X DELETE "http://localhost:3013/api/kv/_/string/string"
Empty
Empty
Empty
GET
/api/kv/_/{namespace}/{key}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

namespace*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512
key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Response Body

curl -X GET "http://localhost:3013/api/kv/_/string/string"
Empty
Empty
Empty
PUT
/api/kv/_/{namespace}/{key}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

namespace*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512
key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PUT "http://localhost:3013/api/kv/_/string/string" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
Empty
Empty
POST
/api/kv/_/{namespace}/{key}/incr

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

namespace*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512
key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

by?integer

Response Body

curl -X POST "http://localhost:3013/api/kv/_/string/string/incr" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
Empty
Empty
DELETE
/api/kv/{key}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Response Body

curl -X DELETE "http://localhost:3013/api/kv/string"
Empty
Empty
Empty
Empty
GET
/api/kv/{key}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Response Body

curl -X GET "http://localhost:3013/api/kv/string"
Empty
Empty
Empty
PUT
/api/kv/{key}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PUT "http://localhost:3013/api/kv/string" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
Empty
Empty
POST
/api/kv/{key}/incr

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

key*string
Match^[a-zA-Z0-9._:/%-]{1,512}$
Length1 <= length <= 512

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

by?integer

Response Body

curl -X POST "http://localhost:3013/api/kv/string/incr" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
Empty
Empty