AgentSession

Attach artifacts to an agent session

Attaches artifacts to an agent session without writing a message. Additive: each supplied artifact is merged into the session's related_artifacts under the same identity rule the message endpoints use — inline artifacts by name, remote artifacts by entity_kind + entity_id — with the supplied artifact winning on a collision and everything else left untouched. Re-sending the same artifact is therefore idempotent. Returns the session's merged artifact list, not the whole session. Use this, rather than the message endpoints, to record a link (a deployment event, a test run, another agent session) onto a session that is not otherwise being written to.

post/agentSession/{id}/artifacts

Path parameters

idstring required

The ID of the agent session

Request body

Response

The session's related artifacts after the merge

warningstring

Present when the write succeeded but did not store everything it was sent — today, only when the session is already at its related-artifact limit, where excess incoming artifacts are dropped rather than failing a write that may also carry messages.

Changes

Changed in 2 of the 32 revisions of this API.12

  • daadc556ff0d11See the full diff
    • ●

      added the new PlanRun enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ○

      added the new PlanRun enum value to the request property //////

      request-property-enum-value-added

    • ○

      endpoint added

      endpoint-added