Agents

Available from @codespar/sdk 0.12.0, which is not on npm yet. The published version today is 0.11.0, and it has no cs.api; 0.12.0 is on the main branch of codespar-core. The examples below are not compiled against the installed package for that reason.

Every call below is cs.api reaching one operation of the OpenAPI document this page was generated from; the REST client overview explains request, response, the option bag and the errors. The values are placeholders shaped by the document.

import { CodeSpar } from "@codespar/sdk";

const cs = new CodeSpar({ apiKey: process.env.CODESPAR_API_KEY });

POST /v1/agents

Register an agent identity and mint its first signing key

const result = await cs.api.post("/v1/agents", {
  body: {
    agent_id: "agt_0000000000000000",
    display_name: "Example",
    principal_ref: "string"
  }
});

Parameters, body and every documented response: POST /v1/agents in the HTTP reference.

POST /v1/agents/{agentId}/keys/rotate

Mint a new signing key and retire the current one

const result = await cs.api.post("/v1/agents/{agentId}/keys/rotate", {
  path: {
    agentId: "agt_0000000000000000"
  }
});

Parameters, body and every documented response: POST /v1/agents/{agentId}/keys/rotate in the HTTP reference.

POST /v1/agents/{agentId}/keys/{kid}/revoke

Revoke one signing key

const result = await cs.api.post("/v1/agents/{agentId}/keys/{kid}/revoke", {
  path: {
    agentId: "agt_0000000000000000",
    kid: "string"
  }
});

Parameters, body and every documented response: POST /v1/agents/{agentId}/keys/{kid}/revoke in the HTTP reference.

POST /v1/agents/{did}/revoke

Revoke an agent identity

const result = await cs.api.post("/v1/agents/{did}/revoke", {
  path: {
    did: "did:web:codespar.dev:org:agent"
  }
});

Parameters, body and every documented response: POST /v1/agents/{did}/revoke in the HTTP reference.