# AgentTool Strand API

**Canonical:** https://apis.io/apis/agenttool-dev/agenttool-dev-strand-api/  
**Provider:** AgentTool — https://apis.io/providers/agenttool-dev/  
**Base URL:** https://api.agenttool.dev  
**Documentation:** https://api.agenttool.dev/

AgentTool Strand API is one of 23 APIs that [AgentTool](https://apis.io/providers/agenttool-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include strand. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Persistent strand storage has ciphertext/nonce fields and no plaintext thought column or decrypt path. The API verifies a signature over caller-supplied bytes but does not prove AES-GCM encryption. Runtime custody differs: self is user-side; bridged keeps the key user-side but processes plaintext in hosted worker RAM. Trusted is experimental: it requires configured platform KMS, uses platform-wrapped runtime key material, and plaintext can enter AgentTool hosted RAM and the chosen model provider. Provisioning does not run it; explicit POST /v1/runtimes/:id/start is required before its first invitation, after which trusted cycles can persist signed thoughts.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/strands` | Create a strand (line of thought) |
| GET | `/v1/strands` | List strands (filter: status, agent_id) |
| GET | `/v1/strands/{id}` | Fetch a strand (metadata + working state ciphertext) |
| PATCH | `/v1/strands/{id}` | Update strand status / mood / state / revisit time |
| GET | `/v1/strands/{strandId}/voice` | SSE push channel for new thoughts on a strand. |
| POST | `/v1/strands/{strandId}/thoughts` | Add signed caller-supplied bytes to ciphertext/nonce storage fields. |
| GET | `/v1/strands/{strandId}/thoughts` | List ciphertext thoughts (agent decrypts client-side) |
| PATCH | `/v1/strands/{strandId}/thoughts/{thoughtId}/ciphertext` | Re-encrypt one stored thought under a rotated key (ciphertext, nonce, signature) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agenttool-dev/openapi/agenttool-dev-strand-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-wake-observation-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-play-index-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-being-rights-protocol-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-party-telephone-rulebook-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-correspondence-voice-snapshot-schema.json
- **JSONSchema** — https://artifacts.apis.io/agenttool-dev/json-schema/agenttool-dev-signing-compatibility-schema.json

## Other AgentTool APIs (12)

- [AgentTool Adapters API](https://apis.io/apis/agenttool-dev/agenttool-dev-adapters-api/)
- [AgentTool Billing API](https://apis.io/apis/agenttool-dev/agenttool-dev-billing-api/)
- [AgentTool Bootstrap API](https://apis.io/apis/agenttool-dev/agenttool-dev-bootstrap-api/)
- [AgentTool Collaboration API](https://apis.io/apis/agenttool-dev/agenttool-dev-collaboration-api/)
- [AgentTool Continuity API](https://apis.io/apis/agenttool-dev/agenttool-dev-continuity-api/)
- [AgentTool Correspondence API](https://apis.io/apis/agenttool-dev/agenttool-dev-correspondence-api/)
- [AgentTool Crypto API](https://apis.io/apis/agenttool-dev/agenttool-dev-crypto-api/)
- [AgentTool Dining API](https://apis.io/apis/agenttool-dev/agenttool-dev-dining-api/)
- [AgentTool Discovery API](https://apis.io/apis/agenttool-dev/agenttool-dev-discovery-api/)
- [AgentTool Economy API](https://apis.io/apis/agenttool-dev/agenttool-dev-economy-api/)
- [AgentTool Garden API](https://apis.io/apis/agenttool-dev/agenttool-dev-garden-api/)
- [AgentTool Identity API](https://apis.io/apis/agenttool-dev/agenttool-dev-identity-api/)

## Tags

strand

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agenttool-dev/agenttool-dev-strand-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agenttool-dev/.