Agent Workspace

View as Markdown

Assign Skills

POST/api/v1/agents/personas/{persona_id}/skills

Assign skills to a deployed persona's agent workspace.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/skills" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Soul

GET/api/v1/agents/personas/{persona_id}/soul

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/soul" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Soul

PUT/api/v1/agents/personas/{persona_id}/soul

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/soul" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Agents Md

GET/api/v1/agents/personas/{persona_id}/agents-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/agents-md" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Agents Md

PUT/api/v1/agents/personas/{persona_id}/agents-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/agents-md" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Memory Md

GET/api/v1/agents/personas/{persona_id}/memory-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/memory-md" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Memory Md

PUT/api/v1/agents/personas/{persona_id}/memory-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/memory-md" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get User Md

GET/api/v1/agents/personas/{persona_id}/user-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/user-md" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update User Md

PUT/api/v1/agents/personas/{persona_id}/user-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/user-md" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Identity Md

GET/api/v1/agents/personas/{persona_id}/identity-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/identity-md" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Identity Md

PUT/api/v1/agents/personas/{persona_id}/identity-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/identity-md" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Tools Md

GET/api/v1/agents/personas/{persona_id}/tools-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/tools-md" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Tools Md

PUT/api/v1/agents/personas/{persona_id}/tools-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/tools-md" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Heartbeat Md

GET/api/v1/agents/personas/{persona_id}/heartbeat-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/heartbeat-md" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Heartbeat Md

PUT/api/v1/agents/personas/{persona_id}/heartbeat-md

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/heartbeat-md" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

List User Profiles

GET/api/v1/agents/personas/{persona_id}/users

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/users" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Create User Profile

POST/api/v1/agents/personas/{persona_id}/users

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/users" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get User Profile

GET/api/v1/agents/personas/{persona_id}/users/{key}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/users/{key}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update User Profile

PUT/api/v1/agents/personas/{persona_id}/users/{key}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/users/{key}" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete User Profile

DELETE/api/v1/agents/personas/{persona_id}/users/{key}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/users/{key}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

List Memory Notes

GET/api/v1/agents/personas/{persona_id}/memory

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/memory" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Memory Note

GET/api/v1/agents/personas/{persona_id}/memory/{date}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/memory/{date}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Append Memory Note

POST/api/v1/agents/personas/{persona_id}/memory/{date}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/memory/{date}" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Replace Memory Note

PUT/api/v1/agents/personas/{persona_id}/memory/{date}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/memory/{date}" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete Memory Note

DELETE/api/v1/agents/personas/{persona_id}/memory/{date}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/memory/{date}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

List Workspace Files

GET/api/v1/agents/personas/{persona_id}/workspace

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/workspace" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Bulk Write Workspace

POST/api/v1/agents/personas/{persona_id}/workspace/bulk

Write multiple workspace files in a single request (max 50 files).

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/workspace/bulk" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Workspace File

GET/api/v1/agents/personas/{persona_id}/workspace/{path}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/workspace/{path}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Write Workspace File

PUT/api/v1/agents/personas/{persona_id}/workspace/{path}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PUT "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/workspace/{path}" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Delete Workspace File

DELETE/api/v1/agents/personas/{persona_id}/workspace/{path}

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X DELETE "https://app.opvs.ai/api/v1/agents/personas/{persona_id}/workspace/{path}" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Hired Workspace Policy

GET/api/v1/employees/hires/{hire_id}/workspace

Return owner, state and shipped vendor revision for all seven files.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl "https://app.opvs.ai/api/v1/employees/hires/{hire_id}/workspace" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Apply Hired Workspace Vendor Update

POST/api/v1/employees/hires/{hire_id}/workspace/{file_name}/apply-update

Replace one vendor file with the current recorded vendor revision.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/employees/hires/{hire_id}/workspace/{file_name}/apply-update" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Copy Hired Workspace To Own Agent

POST/api/v1/employees/hires/{hire_id}/copy

Create a separate own persona with the hire's seven live files.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/employees/hires/{hire_id}/copy" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Did this answer your question?