Configure Import API
The Import API from Configure — 3 operation(s) for import.
The Import API from Configure — 3 operation(s) for import.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/configure-dev:configure-dev-import-api"
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.
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: 3.2.0
info:
title: Configure Dev Import API
version: 2026-07-12
description: 'Operations tagged Import across 2 of this provider''s published API definitions: configure-dev-openapi-original.yaml, configure-dev-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
security:
- ApiKeyAuth: []
tags:
- name: Import
paths:
/v1/import/profiles:
post:
tags:
- Import
summary: Import or backfill many profiles
description: Server-side secret-key-only bulk import for historical dialogue or existing profile artifacts. Import is not a model tool, does not use profile.commit(), and does not write root profile files.
security:
- SecretApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ImportProfilesRequest'
responses:
'202':
description: Import job queued.
content:
application/json:
schema:
$ref: '#/components/schemas/ImportJob'
'200':
description: Existing idempotent import job returned.
content:
application/json:
schema:
$ref: '#/components/schemas/ImportJob'
'402':
$ref: '#/components/responses/QuotaExceeded'
'413':
$ref: '#/components/responses/PayloadTooLarge'
'422':
$ref: '#/components/responses/InvalidFormat'
'429':
$ref: '#/components/responses/RateLimited'
operationId: postV1ImportProfiles
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/import/jobs/{jobId}:
get:
tags:
- Import
summary: Get an import job
security:
- SecretApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
- $ref: '#/components/parameters/ImportJobIdPath'
responses:
'200':
description: Import job status.
content:
application/json:
schema:
$ref: '#/components/schemas/ImportJob'
operationId: getV1ImportJobsByJobId
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
/v1/import/jobs/{jobId}/cancel:
post:
tags:
- Import
summary: Cancel an import job
security:
- SecretApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/AgentHeader'
- $ref: '#/components/parameters/ImportJobIdPath'
responses:
'200':
description: Import job after cancellation request.
content:
application/json:
schema:
$ref: '#/components/schemas/ImportJob'
operationId: postV1ImportJobsByJobIdCancel
x-operation-id-source: derived
servers:
- url: https://api.configure.dev
description: Production
- url: https://configure-backend-staging.fly.dev
description: Staging
components:
parameters:
ImportJobIdPath:
name: jobId
in: path
required: true
schema:
type: string
pattern: ^imp_[a-f0-9]{32}$
AgentHeader:
name: X-Agent
in: header
required: false
schema:
$ref: '#/components/schemas/AgentName'
description: Required when the API key's developer account owns more than one active agent.
schemas:
ImportJob:
type: object
properties:
id:
type: string
pattern: ^imp_[a-f0-9]{32}$
mode:
type: string
enum:
- backfill
status:
type: string
enum:
- queued
- processing
- completed
- failed
- cancelled
accepted_profiles:
type: integer
estimated_message_count:
type: integer
estimated_input_chars:
type: integer
imported_memory_count:
type: integer
processed_profile_count:
type: integer
failed_profile_count:
type: integer
quota:
type: object
properties:
imported_profiles:
$ref: '#/components/schemas/ImportQuotaState'
caps:
$ref: '#/components/schemas/ImportCaps'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
started_at:
type: string
format: date-time
nullable: true
completed_at:
type: string
format: date-time
nullable: true
cancelled_at:
type: string
format: date-time
nullable: true
ErrorEnvelope:
type: object
properties:
error:
type: object
properties:
type:
type: string
code:
type: string
message:
type: string
param:
type:
- string
- 'null'
retryable:
type: boolean
request_id:
type: string
ImportProfileUser:
type: object
required:
- externalId
additionalProperties: false
properties:
externalId:
type: string
minLength: 1
maxLength: 255
description: Developer app-local subject ID. It never becomes a storage path.
idempotencyKey:
type: string
maxLength: 200
profile:
type: object
additionalProperties: true
properties:
summary:
type: string
preferences:
type: array
items:
type: string
facts:
type: array
items:
type: string
identity:
type: object
additionalProperties:
type: string
conversations:
type: array
maxItems: 250
items:
$ref: '#/components/schemas/ImportConversation'
ImportMessage:
type: object
required:
- role
- content
additionalProperties: false
properties:
role:
type: string
enum:
- system
- user
- assistant
- tool
content:
type: string
minLength: 1
maxLength: 20000
ImportConversation:
type: object
required:
- messages
additionalProperties: false
properties:
id:
type: string
maxLength: 200
messages:
type: array
minItems: 1
maxItems: 1000
items:
$ref: '#/components/schemas/ImportMessage'
ImportCaps:
type: object
properties:
max_profiles_per_job:
type: integer
max_total_input_chars_per_job:
type: integer
max_concurrent_import_jobs:
type: integer
max_conversations_per_profile:
type: integer
max_messages_per_conversation:
type: integer
max_chars_per_message:
type: integer
ImportQuotaState:
type: object
properties:
used:
type: integer
limit:
oneOf:
- type: integer
- type: string
enum:
- unlimited
requestedNew:
type: integer
remaining:
oneOf:
- type: integer
- type: string
enum:
- unlimited
ImportProfilesRequest:
type: object
required:
- mode
- users
additionalProperties: false
properties:
mode:
type: string
enum:
- backfill
idempotencyKey:
type: string
maxLength: 200
description: Scoped to the developer account and acting agent.
users:
type: array
minItems: 1
maxItems: 10000
items:
$ref: '#/components/schemas/ImportProfileUser'
description: Request bodies may not set path, source, written_by, timestamps, or memory IDs.
AgentName:
type: string
minLength: 2
maxLength: 63
pattern: ^[a-z0-9][a-z0-9-]*[a-z0-9]$
example: your-agent
responses:
QuotaExceeded:
description: Quota exceeded. Import quota failures happen before job creation or raw payload persistence.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
PayloadTooLarge:
description: Payload exceeds a configured cap.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
InvalidFormat:
description: Request shape is invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
RateLimited:
description: Rate or concurrency limit exceeded.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Configure API key. Use sk_ on servers. pk_ is browser-safe but restricted.
SecretApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Server-side Configure secret key, prefix sk_.
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: Agent-scoped Configure token from hosted Configure.link().
ExternalUserId:
type: apiKey
in: header
name: X-User-Id
description: Stable external user ID for unlinked developer-scoped profiles. Requires sk_.
x-refined-from:
- configure-dev-openapi-original.yaml
- configure-dev-openapi.yml