API guide
Context API
Context API 是默认聚合入口，适合先拿到高信号职业上下文，再按需展开。
Path: /api/v1/context
Format: AI-first docs
信息
Contract-backed page
这一页直接从当前 OpenAPI 契约生成摘要，用来保证文档路径和正式接口保持一致。
GET /api/v1/context
Get aggregated agent context
Default agent entrypoint. Returns a compact high-signal summary by default and can expand into the normalized career graph, dynamic context, alerts, health, and sharing preferences.
Required scopes
read:context
Request
- view (query): compact (default) returns the summary only. full automatically includes the full careerGraph unless overridden.
- expand (query): Comma-separated expansions. Allowed: careerGraph,dynamicContext,alerts,careerHealth,dataSharing.
- query (query): Only used when expand includes dynamicContext.
- timeRange (query): Only used when expand includes dynamicContext.
- includeMemories (query): Only used when expand includes dynamicContext.
- careerGraph (query): When careerGraph is included, choose summary to receive the normalized graph projection without recommendations.
- resumeSkillsLimit (query): Limits resume skills in summary mode and in careerGraph=summary.
- alertsLimit (query): Limits alerts returned when expand includes alerts.
Responses
- 200: OK
- 304: Not Modified
- 400: Bad request
- 401:
- 402:
- 403:
- 404: Context not found
- 429:
- 500:
Errors
context.invalid_viewvalidation.bad_requestcontext.not_found
Examples
Code sample (curl)
1
curl "https://profileclaw.cn/api/v1/context" -H "Authorization: Bearer $PROFILECLAW_API_KEY"Code sample (curl)
1
curl "https://profileclaw.cn/api/v1/context?view=full" -H "Authorization: Bearer $PROFILECLAW_API_KEY"Code sample (curl)
1
curl "https://profileclaw.cn/api/v1/context?expand=dynamicContext&query=product%20management&timeRange=recent" -H "Authorization: Bearer $PROFILECLAW_API_KEY"Code sample (curl)
1
curl "https://profileclaw.cn/api/v1/context?expand=careerGraph&careerGraph=summary&resumeSkillsLimit=20" -H "Authorization: Bearer $PROFILECLAW_API_KEY"Code sample (curl)
1
curl "https://profileclaw.cn/api/v1/context" -H "Authorization: Bearer $PROFILECLAW_API_KEY" -H 'If-None-Match: "<etag-from-previous-response>"'Related surfaces
Use these surfaces when you need deeper inspection or automation.