Loading…
Loading…
Loading…
Developer Docs
Let your AI agents push career data into AskCV. Import knowledge entries, work experience, skills, projects, and more — all staged for your review before going live.
Go to Settings → API Keys in your AskCV dashboard. Create a new token with agent type and select the scopes you need: agent:read for exporting data, agent:write for importing.
Include your token in every request as a standard Bearer token. The token is shown once at creation and cannot be retrieved later — store it securely.
curl -X POST https://askcv.ai/api/agent/import \
-H "Authorization: Bearer askcv_agt_<token>" \
-H "Content-Type: application/json" \
-d '{"items": [...]}'| Type | Prefix | Default scopes | Use case |
|---|---|---|---|
| extension | askcv_ext_ | extension | Browser extension |
| agent | askcv_agt_ | agent:read, agent:write, agent:query | AI agents (Claude, ChatGPT, etc.) |
| mcp | askcv_mcp_ | mcp | MCP server connections |
Four endpoints for a complete import/export workflow. All responses are JSON.
Ten importable career domains. Each item in a batch specifies a domain and a payloadmatching that domain's schema.
Connect your AI coding assistant to AskCV via the Model Context Protocol. Three tools: import_career_data, get_import_status, and read_career_data.
In your AskCV dashboard, go to Settings → API Keys and create a token with mcp type.
Add the following to your .mcp.json (Claude Code) or equivalent MCP config file. Replace the placeholder token with yours.
{
"mcpServers": {
"askcv": {
"url": "https://askcv.ai/api/mcp",
"headers": {
"Authorization": "Bearer askcv_mcp_YOUR_TOKEN_HERE"
}
}
}
}| Tool | Description |
|---|---|
| import_career_data | Submit career items for staged import (same as POST /api/agent/import) |
| get_import_status | Check the approval status of a previous import batch |
| read_career_data | Read existing career data for a domain (dedup check) |
Example workflow
“After a performance review, ask your AI assistant to extract accomplishments and push them to AskCV. They land in your review inbox and become knowledge base entries on approval.”
Sync coaching notes
“Have your coding agent create coaching action items from code review feedback or 1:1 meeting notes.”
Export and dedup
“Read existing skills before importing new ones. The export endpoint lets agents check what you already have.”
All endpoints are rate-limited per tenant. Exceeding the limit returns a 429 response with a retryAfterMs field.
| Endpoint | Limit | Scope |
|---|---|---|
| POST /api/agent/import | 20 batches/hour | Per tenant |
| GET /api/agent/import/[batchId] | 120 requests/hour | Per tenant |
| GET /api/agent/export/[domain] | 120 requests/hour | Per tenant per domain |
| GET /api/agent/profile | 120 requests/hour | Per tenant |
Batch size cap: 100 items per import request. Export pagination: max 100 items/page (default 50).
01
Agent submits
Your AI agent sends a POST request with career data items. Each item is validated against its domain schema.
02
Staged for review
Valid items land in your import inbox as pending. Invalid items are returned in the error response.
03
You approve
Review each item in your dashboard. Approve individually or in bulk. Rejected items are discarded.
04
Data goes live
Approved items flow through ingestion pipelines: PII detection, embeddings, AI analysis. They become part of your career knowledge base.
Create your AskCV account, generate an API key, and start importing career data in under 5 minutes.