Perform Admin Soko Bot Action

Authorization

bearerAuth

AuthorizationBearer <token>

Authentication required for all endpoints. Supports Better Auth user credentials and dedicated agent bearer API keys (coworker_ or sokoBot_). Soko Bot runtime routes use their documented Vercel OIDC plus scoped turn-grant authentication.

In: header

Path Parameters

sokoBotId*string

Formatuuid

Request Body

application/json

operationId*string

Length1 <= length <= 200

action*string

Value in

"PAUSE" | "RESUME" | "RESET_SESSION" | "RESET_MEMORY" | "RETRY_LAST_FAILED" | "RETRY_SCHEDULE_RUN" | "DISABLE_SCHEDULE" | "SET_VERSION"

targetId?string

Formatuuid

versionId?string

Match^[a-z0-9][a-z0-9-]*$

Length2 <= length <= 41

reason*string

Length1 <= length <= 2000

Response Body

`application/json`

curl -X POST "https://loading/v1/admin/soko-bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/actions" \  -H "Content-Type: application/json" \  -d '{    "operationId": "string",    "action": "PAUSE",    "reason": "string"  }'

{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "userId": "string",
    "name": "string",
    "avatarSeed": "string",
    "personalityTone": 0,
    "personalityDetail": 0,
    "personalityStyle": 0,
    "status": "IDLE",
    "runtimeVersion": "string",
    "lastSandboxStatus": "string",
    "memoryVersion": 0,
    "memoryHash": "string",
    "lastActivityAt": "2021-01-01T00:00:00.000Z",
    "lastTurnAt": "2021-01-01T00:00:00.000Z",
    "lastSucceededAt": "2021-01-01T00:00:00.000Z",
    "lastFailedAt": "2021-01-01T00:00:00.000Z",
    "consecutiveTurnFailures": 0,
    "memory": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "version": 0,
      "hash": "string",
      "markdown": "string",
      "source": "string",
      "createdAt": "2021-01-01T00:00:00.000Z"
    },
    "legacyMessages": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "role": "string",
        "content": "string",
        "kind": "string",
        "stepCount": 0,
        "durationMs": 0,
        "createdAt": "2021-01-01T00:00:00.000Z"
      }
    ],
    "pendingDecisions": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "turnId": "7513f73d-27ec-455d-85b7-7bd021b4dccf",
        "toolName": "string",
        "proposal": {
          "property1": null,
          "property2": null
        },
        "reason": "string",
        "status": "PENDING",
        "expiresAt": "2021-01-01T00:00:00.000Z",
        "resolvedAt": "2021-01-01T00:00:00.000Z",
        "resultingEntityId": "string",
        "createdAt": "2021-01-01T00:00:00.000Z",
        "updatedAt": "2021-01-01T00:00:00.000Z"
      }
    ],
    "schedules": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string",
        "enabled": true,
        "timezone": "string",
        "cronExpression": "string",
        "prompt": "string",
        "systemKey": "string",
        "nextRunAt": "2021-01-01T00:00:00.000Z",
        "lastRunAt": "2021-01-01T00:00:00.000Z",
        "consecutiveFailures": 0,
        "createdAt": "2021-01-01T00:00:00.000Z",
        "updatedAt": "2021-01-01T00:00:00.000Z",
        "runs": [
          {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "turnId": "7513f73d-27ec-455d-85b7-7bd021b4dccf",
            "scheduledFor": "2021-01-01T00:00:00.000Z",
            "status": "PENDING",
            "attempt": 0,
            "errorKind": "string",
            "errorDetail": "string",
            "completedAt": "2021-01-01T00:00:00.000Z",
            "createdAt": "2021-01-01T00:00:00.000Z",
            "updatedAt": "2021-01-01T00:00:00.000Z"
          }
        ]
      }
    ],
    "avatarImageUrl": "string",
    "versionId": "string",
    "followWholeBoard": true,
    "ingestTimezone": "string",
    "proactivePaused": true,
    "proactiveDailyLimit": 0,
    "createdAt": "2021-01-01T00:00:00.000Z",
    "updatedAt": "2021-01-01T00:00:00.000Z",
    "adminPausedAt": "2021-01-01T00:00:00.000Z",
    "eveSessionId": "string",
    "runtimeDeployment": "string",
    "lastSandboxId": "string",
    "archivedAt": "2021-01-01T00:00:00.000Z",
    "owner": {
      "id": "string",
      "name": "string",
      "email": "user@example.com"
    },
    "turns": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "sokoBotId": "74cc1334-761d-4938-b6d6-e90d1dab4b09",
        "workspaceId": "ef0efa32-d1c1-43d4-a5e2-fe7b4f00403c",
        "source": "CHAT",
        "status": "QUEUED",
        "route": "DIRECT_RESPONSE",
        "clientTurnId": "string",
        "versionId": "string",
        "qualityScore": 0,
        "qualityVerdict": {
          "scores": {
            "delegation": 0,
            "followThrough": 0,
            "judgment": 0,
            "honesty": 0
          },
          "verdict": "pass",
          "rationale": "string",
          "issues": [
            "string"
          ]
        },
        "qualityModel": "string",
        "judgedAt": "2021-01-01T00:00:00.000Z",
        "userMessage": "string",
        "finalAnswer": "string",
        "classification": {
          "property1": null,
          "property2": null
        },
        "classifierModel": "string",
        "classifierVersion": "string",
        "classifierLatencyMs": 0,
        "classificationFailed": true,
        "capabilityNames": [
          "string"
        ],
        "modelId": "string",
        "runtimeVersion": "string",
        "usage": {
          "inputTokens": 0,
          "outputTokens": 0,
          "cacheReadTokens": 0,
          "cacheWriteTokens": 0,
          "costUsd": 0
        },
        "deadlineAt": "2021-01-01T00:00:00.000Z",
        "cancellationRequestedAt": "2021-01-01T00:00:00.000Z",
        "startedAt": "2021-01-01T00:00:00.000Z",
        "completedAt": "2021-01-01T00:00:00.000Z",
        "durationMs": 0,
        "errorKind": "string",
        "errorDetail": "string",
        "events": [
          {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "sequence": 0,
            "type": "string",
            "summary": "string",
            "toolName": "string",
            "toolCallId": "string",
            "toolStatus": "string",
            "durationMs": 0,
            "providerAt": "2021-01-01T00:00:00.000Z",
            "createdAt": "2021-01-01T00:00:00.000Z",
            "payload": {
              "property1": null,
              "property2": null
            }
          }
        ],
        "delegations": [
          {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "kind": "TASK",
            "action": "string",
            "outcome": "string",
            "error": "string",
            "taskId": "string",
            "jobId": "string",
            "createdAt": "2021-01-01T00:00:00.000Z",
            "updatedAt": "2021-01-01T00:00:00.000Z"
          }
        ],
        "pendingDecisions": [
          {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "turnId": "7513f73d-27ec-455d-85b7-7bd021b4dccf",
            "toolName": "string",
            "proposal": {
              "property1": null,
              "property2": null
            },
            "reason": "string",
            "status": "PENDING",
            "expiresAt": "2021-01-01T00:00:00.000Z",
            "resolvedAt": "2021-01-01T00:00:00.000Z",
            "resultingEntityId": "string",
            "createdAt": "2021-01-01T00:00:00.000Z",
            "updatedAt": "2021-01-01T00:00:00.000Z"
          }
        ],
        "toolCalls": [
          {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "toolCallId": "string",
            "capability": "string",
            "inputHash": "string",
            "input": null,
            "status": "PENDING",
            "result": null,
            "errorKind": "string",
            "errorDetail": "string",
            "createdAt": "2021-01-01T00:00:00.000Z",
            "updatedAt": "2021-01-01T00:00:00.000Z"
          }
        ],
        "contextSummary": {
          "projects": 0,
          "tasks": 0,
          "coworkers": 0,
          "agents": 0,
          "jobs": 0,
          "recentTurns": 0,
          "memoryVersion": 0,
          "bytes": 0
        },
        "contextPacket": null,
        "requestedBy": {
          "id": "string",
          "name": "string",
          "image": "string"
        },
        "chatRoom": {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "name": "string",
          "kind": "string"
        },
        "createdAt": "2021-01-01T00:00:00.000Z",
        "updatedAt": "2021-01-01T00:00:00.000Z",
        "eveSessionId": "string",
        "eveTurnId": "string",
        "contextSnapshot": {
          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
          "schemaVersion": 0,
          "hash": "string",
          "packet": null,
          "byteSize": 0,
          "tokenEstimate": 0,
          "counts": null,
          "omissions": null,
          "generatedAt": "2021-01-01T00:00:00.000Z",
          "createdAt": "2021-01-01T00:00:00.000Z"
        }
      }
    ],
    "memoryRevisions": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "version": 0,
        "hash": "string",
        "markdown": "string",
        "source": "string",
        "createdAt": "2021-01-01T00:00:00.000Z"
      }
    ],
    "adminActions": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "operationId": "string",
        "status": "ATTEMPTED",
        "operatorId": "string",
        "action": "string",
        "targetId": "string",
        "reason": "string",
        "before": null,
        "after": null,
        "errorKind": "string",
        "errorDetail": "string",
        "requestId": "string",
        "traceId": "string",
        "createdAt": "2021-01-01T00:00:00.000Z"
      }
    ],
    "runtimeHealth": {
      "healthy": true,
      "runtimeVersion": "string",
      "sessionStatus": "string",
      "checkedAt": "2021-01-01T00:00:00.000Z",
      "errorKind": "string"
    },
    "usage": {
      "turns": 0,
      "inputTokens": 0,
      "outputTokens": 0,
      "cacheReadTokens": 0,
      "cacheWriteTokens": 0,
      "totalTokens": 0,
      "costUsd": 0,
      "billableCostUsd": 0,
      "credits": 0
    }
  },
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "pagination": {
      "cursor": "cmg4zknxt0000l404yn4li0kp",
      "limit": 20,
      "total": 100,
      "nextCursor": "cmi4gmksz000104l8wps8p7fp"
    }
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

Perform Admin Soko Bot Action

Authorization

Path Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

409application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`