---
title: "Receive idempotent context through a signed source endpoint"
method: POST
path: "/imports/http/{id}"
---

# Receive idempotent context through a signed source endpoint

`POST /imports/http/{id}`

## Request

- Base URL: `https://handover.sh/api/v1`
- URL: `https://handover.sh/api/v1/imports/http/{id}`
- Auth: none required

## Path parameters

- `id` string, required

## Headers

- `x-handover-signature` string, required

## Request body

- HttpImportPayload
  - `note` string
  - `brief` ContinuationBrief: An immutable, structured snapshot of what a person or agent needs to resume the work.
    - `objective` string
    - `currentState` string
    - `decisions` string[]
    - `openQuestions` string[]
    - `nextSteps` ContinuationStep[]
      - `id` string, required
      - `text` string, required
      - `status` 'open' | 'done', required
  - `artifactMode` 'merge' | 'replace'
  - `artifacts` ArtifactInput[]
    - `name` string, required
    - `mediaType` string
    - `content` string, required
    - `encoding` 'utf8' | 'base64'
  - `title` string, required
  - `summary` string
  - `schemaVersion` 1
  - `externalId` string, required
  - `providerRef` string, required

## Response `202`

Import accepted or previously processed

## Other responses

- `401`: Request error

---

[API](https://skmtc.dev/handover/apis/handover-api.md) · [All operations](https://skmtc.dev/handover/apis/handover-api/llms.txt) · [OpenAPI document](https://skmtc.dev/handover/apis/handover-api/revisions/846b2a3091df?raw)