Harness Support

Internal operations for agent harnesses managed by Oz

Create external conversation

post

Create a new external conversation record for a harness. Returns a conversation ID for bookkeeping.

This may only be called from within a cloud agent execution environment.

Authorizations

bearerAuth

AuthorizationstringRequired

Authentication via a Warp API key.

Body

application/json

Request body for creating a new external conversation for a third-party harness.

formatstringRequired

The conversation format identifying the harness type.

Responses

200

External conversation created successfully

application/json

conversation_idstringRequired

The unique identifier of the newly created conversation.

400

Invalid request (missing or unsupported format)

application/json

401

Authentication required

application/json

403

No permission to modify the task

application/json

500

Internal server error

application/json

post

/harness-support/external-conversation

HTTPcURLJavaScriptPython

POST /api/v1/harness-support/external-conversation HTTP/1.1
Host: app.warp.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "format": "text"
}

{
  "conversation_id": "text"
}

Resolve effective prompt

post

Resolve the effective prompt for the current task, including optional skill content and attachment references. This may only be called from within a cloud agent execution environment.

Authorizations

bearerAuth

AuthorizationstringRequired

Authentication via a Warp API key.

Body

application/json

Request body for resolving the effective prompt for a task.

attachments_dirstringOptional

Directory where attachments were downloaded locally

Responses

200

Resolved prompt

application/json

promptstringRequired

The resolved prompt

400

Invalid request

application/json

401

Authentication required

application/json

403

No permission to access the task

application/json

500

Internal server error

application/json

post

/harness-support/resolve-prompt

HTTPcURLJavaScriptPython

POST /api/v1/harness-support/resolve-prompt HTTP/1.1
Host: app.warp.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "skill": {
    "name": "text",
    "content": "text",
    "path": "text"
  },
  "attachments_dir": "text"
}

{
  "prompt": "text"
}

Prepare upload of a block snapshot

post

Allocates and returns a storage slot for uploading an output snapshot. The caller should make an HTTP request to the target with the serialized snapshot as the request body.

This may only be called from within a cloud agent execution environment.

Authorizations

bearerAuth

AuthorizationstringRequired

Authentication via a Warp API key.

Body

application/json

Request body for obtaining a conversation-scoped upload target.

conversation_idstringRequired

The conversation ID to associate the uploaded data with.

Responses

200

Presigned upload target for the block snapshot

application/json

A description of where and how to upload a blob. Use the method and url to upload, including all headers in the request. Pass the blob to upload as the request body.

urlstring · uriRequired

The presigned URL to upload the blob to.

methodstring · enumRequired

The HTTP method to use for the upload.

Possible values:

400

Invalid request or conversation format does not support block snapshot uploads

application/json

401

Authentication required

application/json

403

No permission to modify the conversation

application/json

404

Conversation or block snapshot slot not found

application/json

500

Internal server error

application/json

post

/harness-support/block-snapshot

HTTPcURLJavaScriptPython

POST /api/v1/harness-support/block-snapshot HTTP/1.1
Host: app.warp.dev
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "conversation_id": "text"
}

{
  "url": "https://example.com",
  "method": "PUT",
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}