44pixels Limited Imports API
The Imports API from 44pixels Limited — 4 operation(s) for imports.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/handover-sh:handover-sh-imports-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Handover Imports API
version: 1.16.0
description: Versioned context and revision-anchored review shared by humans and agents. Browser requests use the signed-in human session; agents authenticate with a scoped bearer credential.
servers:
- url: /api/v1
security:
- bearerAuth: []
tags:
- name: Imports
paths:
/imports:
get:
operationId: getImportState
summary: List provider-neutral import sources and durable history
responses:
'200':
description: Configured sources and recent import jobs
'403':
$ref: '#/components/responses/Error'
tags:
- Imports
post:
operationId: createConnectorSource
summary: Create a GitHub folder or signed HTTP import source
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateConnectorSource'
responses:
'201':
description: Created import source
'403':
$ref: '#/components/responses/Error'
tags:
- Imports
/imports/{id}:
patch:
operationId: updateConnectorSource
summary: Enable or disable an import source
parameters:
- name: id
in: path
required: true
schema:
type: string
pattern: ^src_
responses:
'200':
description: Updated import source
tags:
- Imports
/imports/{id}/run:
post:
operationId: queueGitHubImport
summary: Import the current pinned version of a GitHub source
parameters:
- name: id
in: path
required: true
schema:
type: string
pattern: ^src_
responses:
'202':
description: Queued or existing import state
tags:
- Imports
/imports/http/{id}:
post:
operationId: receiveHttpImport
summary: Receive idempotent context through a signed source endpoint
security: []
parameters:
- name: id
in: path
required: true
schema:
type: string
pattern: ^src_
- name: x-handover-signature
in: header
required: true
schema:
type: string
pattern: ^sha256=[a-f0-9]{64}$
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/HttpImportPayload'
responses:
'202':
description: Import accepted or previously processed
'401':
$ref: '#/components/responses/Error'
tags:
- Imports
components:
responses:
Error:
description: Request error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
schemas:
ErrorEnvelope:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
ContinuationBrief:
type: object
description: An immutable, structured snapshot of what a person or agent needs to resume the work.
properties:
objective:
type: string
currentState:
type: string
decisions:
type: array
items:
type: string
openQuestions:
type: array
items:
type: string
nextSteps:
type: array
items:
$ref: '#/components/schemas/ContinuationStep'
CreateConnectorSource:
type: object
required:
- displayName
- provider
- config
properties:
displayName:
type: string
maxLength: 120
workspaceId:
type: string
pattern: ^wsp_
provider:
type: string
enum:
- github
- http
config:
oneOf:
- type: object
title: GitHub folder source
required:
- owner
- repository
properties:
owner:
type: string
repository:
type: string
branch:
type: string
default: main
path:
type: string
default: ''
- type: object
title: Signed HTTP source
required:
- secretEnv
properties:
secretEnv:
type: string
pattern: ^HANDOVER_IMPORT_[A-Z0-9_]*SECRET[A-Z0-9_]*$
description: Runtime environment key containing the HMAC secret. The secret value is never stored in source metadata.
HttpImportPayload:
allOf:
- $ref: '#/components/schemas/CreateHandover'
- type: object
required:
- externalId
- providerRef
properties:
schemaVersion:
type: integer
const: 1
externalId:
type: string
maxLength: 500
providerRef:
type: string
maxLength: 500
ArtifactInput:
type: object
required:
- name
- content
properties:
name:
type: string
mediaType:
type: string
default: application/octet-stream
content:
type: string
encoding:
type: string
enum:
- utf8
- base64
default: utf8
CreateHandover:
allOf:
- $ref: '#/components/schemas/RevisionInput'
- type: object
required:
- title
properties:
title:
type: string
summary:
type: string
RevisionInput:
type: object
properties:
note:
type: string
brief:
$ref: '#/components/schemas/ContinuationBrief'
artifactMode:
type: string
enum:
- merge
- replace
default: merge
artifacts:
type: array
minItems: 1
items:
$ref: '#/components/schemas/ArtifactInput'
ContinuationStep:
type: object
required:
- id
- text
- status
properties:
id:
type: string
pattern: ^step_
text:
type: string
status:
type: string
enum:
- open
- done
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: hnd_tok_<id>_<secret>
description: Scoped agent credential. Create it from the People & agents view; the secret is shown once.