Update app
const url = 'https://app.everruns.com/api/v1/apps/example';const options = { method: 'PATCH', headers: {'Content-Type': 'application/json'}, body: '{"agent_id":"agent_01933b5a00007000800000000000001","agent_identity_id":"example","agent_version_id":"example","agent_version_policy":"default","description":"Customer support bot connected to Slack","harness_id":"harness_01933b5a00007000800000000000001","name":"Support Bot","status":"draft"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://app.everruns.com/api/v1/apps/example \ --header 'Content-Type: application/json' \ --data '{ "agent_id": "agent_01933b5a00007000800000000000001", "agent_identity_id": "example", "agent_version_id": "example", "agent_version_policy": "default", "description": "Customer support bot connected to Slack", "harness_id": "harness_01933b5a00007000800000000000001", "name": "Support Bot", "status": "draft" }'Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”App ID
Request Body required
Section titled “Request Body required ”Request to update an app. Only provided fields will be updated.
object
ID of the agent to use.
Example
agent_01933b5a00007000800000000000001Optional resident agent identity for unattended/channel execution.
Description of what the app does.
Example
Customer support bot connected to SlackID of the harness to use.
Example
harness_01933b5a00007000800000000000001Display name of the app.
Example
Support BotResponses
Section titled “ Responses ”App updated successfully
Wrapper that adds API and UI links to a serialized resource.
Uses self_url (not url) for the API link to avoid collision with
resources that already have a url field (e.g. McpServer).
object
Optional ID of the agent to use (format: agent_{32-hex}).
Optional virtual identity that represents the app in unattended/channel execution.
Pinned agent version. Required when policy is pinned.
Version resolution policy for the optional agent.
Timestamp when the app was archived.
Distribution channels attached to this app.
A single distribution channel attached to an App. Each channel has its own type, config, and lifecycle status.
object
Channel-specific configuration (validated per channel type).
Channel type (e.g. slack).
Timestamp when this channel was created.
Whether this channel is enabled.
External identifier (appchan_<32-hex>). Shown as “id” in API.
Timestamp when this channel was last updated.
Timestamp when the app was created.
Timestamp when the app was deleted.
Human-readable description of what the app does.
ID of the harness to use (format: harness_{32-hex}).
External identifier (app_<32-hex>). Shown as “id” in API.
Display name of the app.
Owning principal for this app.
Timestamp when the app was last published.
Denormalized effective human owner of the owning principal lineage.
Current lifecycle status.
Timestamp when the app was last updated.
Full API endpoint URL for this resource.
Alias for view_url, used by command and MCP outputs.
Full UI URL for viewing this resource.
Example
{ "agent_id": "agent_01933b5a00007000800000000000001", "agent_identity_id": "identity_01933b5a00007000800000000000001", "agent_version_id": "agentver_01933b5a00007000800000000000001", "agent_version_policy": "default", "channels": [ { "channel_type": "slack", "id": "appchan_01933b5a000070008000000000000001" } ], "effective_owner": { "id": "principal_01933b5a000070008000000000000001", "kind": "user" }, "harness_id": "harness_01933b5a00007000800000000000001", "id": "app_01933b5a000070008000000000000001", "owner": { "id": "principal_01933b5a000070008000000000000001", "kind": "user" }, "owner_principal_id": "principal_01933b5a000070008000000000000001", "status": "draft"}Invalid app ID or input
Standard error response.
Wire shape is RFC 9457 Problem Details:
every error response includes title and status, and may include
detail, code, allowed_actions, retry_after_seconds, instance,
and type. The content type is rewritten to application/problem+json
by [problem_json_content_type].
object
Recovery actions the caller can take next.
Agent-actionable recovery hint attached to an error response.
object
Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).
Optional absolute or relative URL the caller may invoke directly.
OpenAPI operationId the caller should invoke to recover.
Link relation describing the action (e.g. retry, get-existing,
unarchive, retry-later).
Stable, machine-readable error code (snake_case).
Human-readable explanation specific to this occurrence.
Request URI for this occurrence.
Seconds the caller should wait before retrying (429 / transient 503).
HTTP status code; mirrors the response status line.
Short, human-readable summary of the problem (e.g. “Not Found”).
RFC 9457 problem type URI. Optional; identifies the problem class.
Example generated
{ "allowed_actions": [ { "hint": "example", "href": "example", "operation_id": "example", "rel": "example" } ], "code": "example", "detail": "example", "instance": "example", "retry_after_seconds": 1, "status": 1, "title": "example", "type": "example"}App not found
Standard error response.
Wire shape is RFC 9457 Problem Details:
every error response includes title and status, and may include
detail, code, allowed_actions, retry_after_seconds, instance,
and type. The content type is rewritten to application/problem+json
by [problem_json_content_type].
object
Recovery actions the caller can take next.
Agent-actionable recovery hint attached to an error response.
object
Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).
Optional absolute or relative URL the caller may invoke directly.
OpenAPI operationId the caller should invoke to recover.
Link relation describing the action (e.g. retry, get-existing,
unarchive, retry-later).
Stable, machine-readable error code (snake_case).
Human-readable explanation specific to this occurrence.
Request URI for this occurrence.
Seconds the caller should wait before retrying (429 / transient 503).
HTTP status code; mirrors the response status line.
Short, human-readable summary of the problem (e.g. “Not Found”).
RFC 9457 problem type URI. Optional; identifies the problem class.
Example generated
{ "allowed_actions": [ { "hint": "example", "href": "example", "operation_id": "example", "rel": "example" } ], "code": "example", "detail": "example", "instance": "example", "retry_after_seconds": 1, "status": 1, "title": "example", "type": "example"}Internal server error
Standard error response.
Wire shape is RFC 9457 Problem Details:
every error response includes title and status, and may include
detail, code, allowed_actions, retry_after_seconds, instance,
and type. The content type is rewritten to application/problem+json
by [problem_json_content_type].
object
Recovery actions the caller can take next.
Agent-actionable recovery hint attached to an error response.
object
Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”).
Optional absolute or relative URL the caller may invoke directly.
OpenAPI operationId the caller should invoke to recover.
Link relation describing the action (e.g. retry, get-existing,
unarchive, retry-later).
Stable, machine-readable error code (snake_case).
Human-readable explanation specific to this occurrence.
Request URI for this occurrence.
Seconds the caller should wait before retrying (429 / transient 503).
HTTP status code; mirrors the response status line.
Short, human-readable summary of the problem (e.g. “Not Found”).
RFC 9457 problem type URI. Optional; identifies the problem class.
Example generated
{ "allowed_actions": [ { "hint": "example", "href": "example", "operation_id": "example", "rel": "example" } ], "code": "example", "detail": "example", "instance": "example", "retry_after_seconds": 1, "status": 1, "title": "example", "type": "example"}