{"openapi":"3.1.0","info":{"title":"Resumez API","version":"v1","description":"The official Resumez API. Programmatically manage career profiles, resumes, skills, and job applications. Endpoints are authorized with OAuth 2.0 scopes. Resumez is in beta — bugs and occasional data loss are possible. Keep exported copies of anything important."},"servers":[{"url":"https://api.resumez.ai"}],"tags":[{"name":"Meta"},{"name":"Identity"},{"name":"Organizations"},{"name":"Skills"},{"name":"Roles"},{"name":"Canonical Profile"},{"name":"Experiences"},{"name":"Educations"},{"name":"Projects"},{"name":"Achievements"},{"name":"Skill Claims"},{"name":"Snippets"},{"name":"Artifacts"},{"name":"Generation"},{"name":"Exports"},{"name":"Jobs"},{"name":"Applications"},{"name":"Submissions"},{"name":"Interviews"},{"name":"Offers"},{"name":"Reminders"},{"name":"Contacts"},{"name":"Notes"},{"name":"Attachments"},{"name":"Events"},{"name":"Operations"},{"name":"Imports"},{"name":"Webhooks"}],"paths":{"/v1/openapi.json":{"get":{"operationId":"meta-openapi","summary":"OpenAPI document","description":"Returns the generated OpenAPI 3.1 contract for stable API consumers.","tags":["Meta"],"responses":{"200":{"description":"Success."}},"x-resumez-status":"implemented","x-resumez-progress":100}},"/v1/me":{"get":{"operationId":"me","summary":"Current principal","description":"Returns the authenticated user, token kind, granted scopes, and canonical-profile readiness.","tags":["Identity"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read"]}]}},"/v1/organizations":{"get":{"operationId":"organizations-list","summary":"List organizations","description":"Lists shared, deduplicated organizations (employers, schools).","tags":["Organizations"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["catalog:read"]}]},"post":{"operationId":"organizations-upsert","summary":"Find or create organization","description":"Links an existing organization or creates one by natural key (name/domain).","tags":["Organizations"],"responses":{"200":{"description":"Returns Organization."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["catalog:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationUpsert"},"example":{"name":"Acme Corp","domain":"acme.com"}}}}}},"/v1/organizations/{organizationId}":{"get":{"operationId":"organization-get","summary":"Get organization","description":"Returns a single shared organization.","tags":["Organizations"],"responses":{"200":{"description":"Returns Organization."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"organizationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["catalog:read"]}]}},"/v1/skills":{"get":{"operationId":"skills-list","summary":"List skills","description":"Lists shared skill taxonomy nodes.","tags":["Skills"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["catalog:read"]}]},"post":{"operationId":"skills-upsert","summary":"Find or create skill","description":"Links an existing skill or creates one by natural key (name).","tags":["Skills"],"responses":{"200":{"description":"Returns Skill."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["catalog:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillUpsert"},"example":{"name":"TypeScript","category":"Programming Languages"}}}}}},"/v1/skills/{skillId}":{"get":{"operationId":"skill-get","summary":"Get skill","description":"Returns a single shared skill taxonomy node.","tags":["Skills"],"responses":{"200":{"description":"Returns Skill."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"skillId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["catalog:read"]}]}},"/v1/roles":{"get":{"operationId":"roles-list","summary":"List roles","description":"Lists normalized role/title taxonomy nodes.","tags":["Roles"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["catalog:read"]}]}},"/v1/roles/{roleId}":{"get":{"operationId":"role-get","summary":"Get role","description":"Returns a single normalized role/title.","tags":["Roles"],"responses":{"200":{"description":"Returns Role."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"roleId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["catalog:read"]}]}},"/v1/profile":{"get":{"operationId":"profile-get","summary":"Get career profile","description":"Returns the canonical career profile aggregate with links to its collections.","tags":["Canonical Profile"],"responses":{"200":{"description":"Returns CareerProfile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CareerProfileResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read"]}]},"patch":{"operationId":"profile-update","summary":"Update career profile","description":"Updates top-level profile identity, preferences, and visibility.","tags":["Canonical Profile"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CareerProfileResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CareerProfilePatch"}}}}}},"/v1/experiences":{"get":{"operationId":"experiences-list","summary":"List experiences","description":"Lists the caller's work, education, project, and volunteer experiences.","tags":["Experiences"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ExperienceResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read"]}]},"post":{"operationId":"experiences-create","summary":"Create experience","description":"Adds an experience that references an Organization and Skills.","tags":["Experiences"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperienceResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperienceCreate"},"example":{"type":"work","title":"Senior Backend Engineer","organization":{"name":"Acme Corp","domain":"acme.com"},"startDate":"2021-03","highlights":["Led the payments rewrite"],"skills":[{"name":"TypeScript"},{"name":"Kafka"}]}}}}}},"/v1/experiences:batchCreate":{"post":{"operationId":"experiences-batch-create","summary":"Batch create experiences","description":"Creates up to 50 experiences in one call with per-item results (AIP-233).","tags":["Experiences"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperienceBatchCreate"}}}}}},"/v1/experiences/{experienceId}":{"get":{"operationId":"experience-get","summary":"Get experience","description":"Returns a single experience with organization and skill references.","tags":["Experiences"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"experienceId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read"]}]},"patch":{"operationId":"experience-update","summary":"Update experience","description":"Updates an experience and its references.","tags":["Experiences"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"experienceId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperiencePatch"}}}}},"delete":{"operationId":"experience-delete","summary":"Delete experience","description":"Removes an experience from the profile.","tags":["Experiences"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"experienceId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}]}},"/v1/experiences/{experienceId}/achievements":{"get":{"operationId":"experience-achievements-list","summary":"List experience achievements","description":"Lists achievements composed under a single experience.","tags":["Experiences"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"experienceId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read"]}]}},"/v1/educations":{"get":{"operationId":"educations-list","summary":"List educations","description":"Lists the caller's education records.","tags":["Educations"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/EducationResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read"]}]},"post":{"operationId":"educations-create","summary":"Create education","description":"Adds an education record referencing a school Organization.","tags":["Educations"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EducationResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EducationCreate"}}}}}},"/v1/educations:batchCreate":{"post":{"operationId":"educations-batch-create","summary":"Batch create educations","description":"Creates up to 50 education records in one call with per-item results (AIP-233).","tags":["Educations"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EducationBatchCreate"}}}}}},"/v1/educations/{educationId}":{"get":{"operationId":"education-get","summary":"Get education","description":"Returns a single education record.","tags":["Educations"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"educationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read"]}]},"patch":{"operationId":"education-update","summary":"Update education","description":"Updates an education record and its school reference.","tags":["Educations"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"educationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EducationPatch"}}}}},"delete":{"operationId":"education-delete","summary":"Delete education","description":"Removes an education record from the profile.","tags":["Educations"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"educationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}]}},"/v1/projects":{"get":{"operationId":"projects-list","summary":"List projects","description":"Lists the caller's projects.","tags":["Projects"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read"]}]},"post":{"operationId":"projects-create","summary":"Create project","description":"Adds a project referencing Skills.","tags":["Projects"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectCreate"}}}}}},"/v1/projects:batchCreate":{"post":{"operationId":"projects-batch-create","summary":"Batch create projects","description":"Creates up to 50 projects in one call with per-item results (AIP-233).","tags":["Projects"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectBatchCreate"}}}}}},"/v1/projects/{projectId}":{"get":{"operationId":"project-get","summary":"Get project","description":"Returns a single project with its skill references.","tags":["Projects"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read"]}]},"patch":{"operationId":"project-update","summary":"Update project","description":"Updates a project; `skills` replaces the skill references when present.","tags":["Projects"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectPatch"}}}}},"delete":{"operationId":"project-delete","summary":"Delete project","description":"Removes a project from the profile.","tags":["Projects"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"projectId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}]}},"/v1/achievements":{"get":{"operationId":"achievements-list","summary":"List achievements","description":"Lists quantified achievements that can become resume bullets.","tags":["Achievements"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read"]}]},"post":{"operationId":"achievements-create","summary":"Create achievement","description":"Adds a quantified achievement referencing an Experience and Skills.","tags":["Achievements"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AchievementCreate"}}}}}},"/v1/achievements:batchCreate":{"post":{"operationId":"achievements-batch-create","summary":"Batch create achievements","description":"Creates up to 50 achievements in one call with per-item results (AIP-233).","tags":["Achievements"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AchievementBatchCreate"}}}}}},"/v1/achievements/{achievementId}":{"get":{"operationId":"achievement-get","summary":"Get achievement","description":"Returns a single achievement.","tags":["Achievements"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"achievementId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read"]}]},"patch":{"operationId":"achievement-update","summary":"Update achievement","description":"Updates an achievement; `skills` replaces the skill references when present.","tags":["Achievements"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"achievementId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AchievementPatch"}}}}},"delete":{"operationId":"achievement-delete","summary":"Delete achievement","description":"Removes an achievement from the profile.","tags":["Achievements"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"achievementId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}]}},"/v1/skill-claims":{"get":{"operationId":"skill-claims-list","summary":"List skill claims","description":"Lists the caller's skill claims (proficiency/evidence) referencing shared Skills.","tags":["Skill Claims"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SkillClaimResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read"]}]},"post":{"operationId":"skill-claims-create","summary":"Create skill claim","description":"Claims a shared Skill with proficiency and evidence. Idempotent per (owner, skill): re-claiming the same skill updates the existing claim rather than duplicating.","tags":["Skill Claims"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillClaimResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillClaimCreate"},"example":{"skill":{"name":"TypeScript"},"proficiency":"advanced","yearsOfExperience":6}}}}}},"/v1/skill-claims:batchCreate":{"post":{"operationId":"skill-claims-batch-create","summary":"Batch create skill claims","description":"Claims up to 50 shared Skills in one call with per-item results (AIP-233).","tags":["Skill Claims"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillClaimBatchCreate"}}}}}},"/v1/skill-claims/{claimId}":{"get":{"operationId":"skill-claim-get","summary":"Get skill claim","description":"Returns a single skill claim.","tags":["Skill Claims"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"claimId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read"]}]},"patch":{"operationId":"skill-claim-update","summary":"Update skill claim","description":"Updates a claim's proficiency, years of experience, or evidence. The claimed Skill itself is immutable — claim a different skill instead.","tags":["Skill Claims"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"claimId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillClaimPatch"}}}}},"delete":{"operationId":"skill-claim-delete","summary":"Delete skill claim","description":"Removes a skill claim from the profile.","tags":["Skill Claims"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"claimId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:write"]}]}},"/v1/snippets":{"get":{"operationId":"snippets-list","summary":"List answer snippets","description":"Lists the caller's saved application answers (work authorization, notice period, salary, …).","tags":["Snippets"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/SnippetResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["snippets:read"]}]},"post":{"operationId":"snippets-create","summary":"Create answer snippet","description":"Saves a canned answer with optional matcher keywords for recurring application questions. Idempotent per (owner, label): re-creating with the same label updates the existing snippet rather than duplicating.","tags":["Snippets"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnippetResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["snippets:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnippetCreate"},"example":{"label":"Work authorization","answer":"Yes, I am authorized to work in the EU without sponsorship.","matchers":["work authorization","authorized to work","right to work"]}}}}}},"/v1/snippets/{snippetId}":{"get":{"operationId":"snippet-get","summary":"Get answer snippet","description":"Returns a single saved answer snippet.","tags":["Snippets"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"snippetId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["snippets:read"]}]},"patch":{"operationId":"snippet-update","summary":"Update answer snippet","description":"Updates a saved answer snippet's label, answer, or matcher keywords.","tags":["Snippets"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnippetResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"snippetId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["snippets:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnippetPatch"}}}}},"delete":{"operationId":"snippet-delete","summary":"Delete answer snippet","description":"Removes a saved answer snippet.","tags":["Snippets"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SnippetDeleteResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"snippetId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["snippets:write"]}]}},"/v1/artifacts":{"get":{"operationId":"artifacts-list","summary":"List artifacts","description":"Lists generated resumes, cover letters, bios, and recruiter briefs.","tags":["Artifacts"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ArtifactResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["artifacts:read"]}]}},"/v1/artifacts/{artifactId}":{"get":{"operationId":"artifact-get","summary":"Get artifact","description":"Returns a single artifact (mutable head).","tags":["Artifacts"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["artifacts:read"]}]},"patch":{"operationId":"artifact-update","summary":"Update artifact","description":"Edits artifact content or metadata; a content change snapshots a new immutable version.","tags":["Artifacts"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["artifacts:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactPatch"}}}}}},"/v1/artifacts/{artifactId}/versions":{"get":{"operationId":"artifact-versions-list","summary":"List artifact versions","description":"Lists immutable version snapshots of an artifact.","tags":["Artifacts"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["artifacts:read"]}]}},"/v1/artifact-versions/{versionId}":{"get":{"operationId":"artifact-version-get","summary":"Get artifact version","description":"Returns a single immutable artifact version (the unit referenced by submissions).","tags":["Artifacts"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"versionId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["artifacts:read"]}]}},"/v1/artifacts:generate":{"post":{"operationId":"artifacts-generate","summary":"Generate artifact","description":"Generates an artifact from the canonical profile and target constraints.","tags":["Generation"],"responses":{"200":{"description":"Returns Operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Profile incomplete","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"profile_incomplete","message":"Profile incomplete","missingRequired":["headline","experience"],"remedy":"Ask the user for their existing resume text or file, then use import_create → import_apply; or collect missing fields and call profile_update / experiences_create."}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["ai:generate","artifacts:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactGenerationRequest"},"example":{"kind":"resume","targetRole":"Senior Backend Engineer"}}}}}},"/v1/artifacts/{artifactId}:export":{"post":{"operationId":"artifact-export","summary":"Export artifact to a stored file","description":"Renders an artifact into a stored file (pdf, json, or txt) in the private exports bucket.","tags":["Exports"],"responses":{"200":{"description":"Returns Operation."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"artifactId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["artifacts:read","artifacts:export"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactFileExportRequest"},"example":{"format":"pdf"}}}}}},"/v1/profile:export":{"post":{"operationId":"profile-export","summary":"Export profile","description":"Exports the canonical profile as JSON Resume, Markdown, or ATS text.","tags":["Exports"],"responses":{"200":{"description":"Returns Operation."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:read","artifacts:export"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtifactExportRequest"}}}}}},"/v1/resume-exports":{"get":{"operationId":"resume-exports-list","summary":"List resume exports","description":"Lists the caller's stored resume exports (PDF/JSON/text files generated in the workspace).","tags":["Exports"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ResumeExportResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["artifacts:export"]}]}},"/v1/resume-exports/{exportId}:download":{"post":{"operationId":"resume-export-download","summary":"Mint export download URL","description":"Mints a short-lived signed download URL for a stored resume export.","tags":["Exports"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResumeExportDownloadResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"exportId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["artifacts:export"]}]}},"/v1/jobs":{"get":{"operationId":"jobs-list","summary":"List jobs","description":"Lists saved job postings.","tags":["Jobs"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"jobs-create","summary":"Create job","description":"Saves a job posting referencing an Organization, Skills, and Role. Browser captures may include bounded extension provenance.","tags":["Jobs"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobCreate"}}}}}},"/v1/jobs/{jobId}":{"get":{"operationId":"job-get","summary":"Get job","description":"Returns a single job posting.","tags":["Jobs"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]},"patch":{"operationId":"job-update","summary":"Update job","description":"Edits a saved job posting; `skills` replaces the skill references when present.","tags":["Jobs"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobPatch"}}}}},"delete":{"operationId":"job-delete","summary":"Delete job","description":"Removes a saved job posting.","tags":["Jobs"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/jobs:parse":{"post":{"operationId":"job-parse","summary":"Parse job description","description":"Extracts role, skills, seniority, and keywords from a job description, retaining optional owner-visible capture provenance.","tags":["Jobs"],"responses":{"200":{"description":"Returns Operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"rate_limited","message":"Rate limit exceeded","retryAfterMs":60000}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["jobs:analyze"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobParseRequest"}}}}}},"/v1/jobs:parse-screenshot":{"post":{"operationId":"job-parse-screenshot","summary":"Parse job screenshot","description":"Analyzes a screenshot of a job posting when text extraction is unavailable, retaining optional owner-visible capture provenance.","tags":["Jobs"],"responses":{"200":{"description":"Returns Operation."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"rate_limited","message":"Rate limit exceeded","retryAfterMs":60000}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["jobs:analyze"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobParseScreenshotRequest"}}}}}},"/v1/jobs/{jobId}:match":{"post":{"operationId":"job-match","summary":"Match profile or resume to job","description":"Deterministically scores the canonical profile or an owned resume artifact/version against a job, returning matched and missing skills, recommendations, and the exact scoring source.","tags":["Jobs"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobMatchResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Profile incomplete","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"profile_incomplete","message":"Profile incomplete","missingRequired":["headline","experience"],"remedy":"Ask the user for their existing resume text or file, then use import_create → import_apply; or collect missing fields and call profile_update / experiences_create."}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read","jobs:analyze"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobMatchRequest"}}}}}},"/v1/jobs/{jobId}:tailor":{"post":{"operationId":"job-tailor","summary":"Tailor artifacts to job","description":"Drafts a tailored resume, cover letter, and recruiter brief for a job. Requires a populated profile; check me.profileReadiness first.","tags":["Jobs"],"responses":{"200":{"description":"Returns Operation."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Profile incomplete","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"profile_incomplete","message":"Profile incomplete","missingRequired":["headline","experience"],"remedy":"Ask the user for their existing resume text or file, then use import_create → import_apply; or collect missing fields and call profile_update / experiences_create."}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read","ai:generate","artifacts:write"]}]}},"/v1/jobs/{jobId}:gap-analysis":{"post":{"operationId":"job-gap-analysis","summary":"Analyze profile gaps","description":"Identifies missing evidence, skills, and signals for a target job. Requires a populated profile; check me.profileReadiness first.","tags":["Jobs"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobGapAnalysisResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Profile incomplete","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"profile_incomplete","message":"Profile incomplete","missingRequired":["headline","experience"],"remedy":"Ask the user for their existing resume text or file, then use import_create → import_apply; or collect missing fields and call profile_update / experiences_create."}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:read","jobs:analyze"]}]}},"/v1/applications":{"get":{"operationId":"applications-list","summary":"List applications","description":"Lists tracked job applications across the pipeline.","tags":["Applications"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApplicationResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"applications-create","summary":"Create application","description":"Starts tracking an application for a linked or new Job.","tags":["Applications"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationCreate"}}}}}},"/v1/applications/{applicationId}":{"get":{"operationId":"application-get","summary":"Get application","description":"Returns an application with stage, links, and activity.","tags":["Applications"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]}},"/v1/applications/{applicationId}:advance":{"post":{"operationId":"application-advance","summary":"Advance application stage","description":"Moves the application to the next pipeline stage.","tags":["Applications"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/applications/{applicationId}:withdraw":{"post":{"operationId":"application-withdraw","summary":"Withdraw application","description":"Withdraws the application from the pipeline.","tags":["Applications"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/applications/{applicationId}:reject":{"post":{"operationId":"application-reject","summary":"Mark application rejected","description":"Records a company-initiated rejection (terminal) — distinct from the caller-initiated withdraw.","tags":["Applications"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/applications/{applicationId}:hold":{"post":{"operationId":"application-hold","summary":"Put application on hold","description":"Pauses an application in place (e.g. hiring freeze); the pipeline stage is preserved.","tags":["Applications"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/applications/{applicationId}:resume":{"post":{"operationId":"application-resume","summary":"Resume application","description":"Clears the on-hold flag; the application resumes at its preserved stage.","tags":["Applications"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/applications:lookup":{"get":{"operationId":"applications-lookup","summary":"Find related applications","description":"Suggests existing applications likely related to a captured page, matched by company name, role title, or posting URL.","tags":["Applications"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationLookupResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]}},"/v1/applications/{applicationId}/events":{"get":{"operationId":"application-events-list","summary":"List application events","description":"Returns the append-only activity timeline for an application.","tags":["Applications"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]}},"/v1/applications/{applicationId}/submissions":{"get":{"operationId":"application-submissions-list","summary":"List submissions","description":"Lists immutable submission records for an application.","tags":["Submissions"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"application-submissions-create","summary":"Create submission","description":"Records an immutable, idempotent submission referencing artifact versions.","tags":["Submissions"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionCreate"}}}}}},"/v1/submissions/{submissionId}":{"get":{"operationId":"submission-get","summary":"Get submission","description":"Returns a single immutable submission.","tags":["Submissions"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"submissionId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]}},"/v1/interviews":{"get":{"operationId":"interviews-list","summary":"List interviews","description":"Lists scheduled and past interviews.","tags":["Interviews"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/InterviewResponse"}},"nextCursor":{"type":["string","null"]}},"required":["data","nextCursor"]}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"interviews-create","summary":"Create interview","description":"Schedules an interview for an application.","tags":["Interviews"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterviewResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterviewCreate"}}}}}},"/v1/interviews/{interviewId}":{"get":{"operationId":"interview-get","summary":"Get interview","description":"Returns a single interview.","tags":["Interviews"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterviewResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"interviewId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]},"patch":{"operationId":"interview-update","summary":"Update interview","description":"Reschedules an interview, changes its kind/location/participants, or records its outcome.","tags":["Interviews"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterviewResponse"}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"interviewId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterviewPatch"}}}}}},"/v1/interviews/{interviewId}:cancel":{"post":{"operationId":"interview-cancel","summary":"Cancel interview","description":"Cancels a scheduled interview (state transition).","tags":["Interviews"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterviewResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"interviewId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/offers":{"get":{"operationId":"offers-list","summary":"List offers","description":"Lists offers across applications.","tags":["Offers"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"offers-create","summary":"Create offer","description":"Records an offer for an application.","tags":["Offers"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OfferCreate"}}}}}},"/v1/offers/{offerId}":{"get":{"operationId":"offer-get","summary":"Get offer","description":"Returns a single offer.","tags":["Offers"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"offerId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]}},"/v1/offers/{offerId}:accept":{"post":{"operationId":"offer-accept","summary":"Accept offer","description":"Accepts an offer (state transition).","tags":["Offers"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"offerId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/offers/{offerId}:decline":{"post":{"operationId":"offer-decline","summary":"Decline offer","description":"Declines an offer (state transition).","tags":["Offers"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"offerId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/reminders":{"get":{"operationId":"reminders-list","summary":"List reminders","description":"Lists the caller's reminders.","tags":["Reminders"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"reminders-create","summary":"Create reminder","description":"Creates a time-anchored reminder for a subject.","tags":["Reminders"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReminderCreate"}}}}}},"/v1/reminders/{reminderId}":{"get":{"operationId":"reminder-get","summary":"Get reminder","description":"Returns a single reminder.","tags":["Reminders"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"reminderId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]},"patch":{"operationId":"reminder-update","summary":"Update reminder","description":"Retitles, re-anchors, or reschedules a reminder.","tags":["Reminders"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"reminderId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReminderPatch"}}}}},"delete":{"operationId":"reminder-delete","summary":"Delete reminder","description":"Removes a reminder.","tags":["Reminders"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"reminderId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/reminders/{reminderId}:complete":{"post":{"operationId":"reminder-complete","summary":"Complete reminder","description":"Marks a reminder done (state transition); completing an already-done reminder is a conflict.","tags":["Reminders"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"reminderId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/reminders/{reminderId}:snooze":{"post":{"operationId":"reminder-snooze","summary":"Snooze reminder","description":"Pushes a reminder's due time forward (state transition to snoozed).","tags":["Reminders"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"reminderId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReminderSnoozeRequest"},"example":{"minutes":1440}}}}}},"/v1/contacts":{"get":{"operationId":"contacts-list","summary":"List contacts","description":"Lists people (recruiters, hiring managers, referrers).","tags":["Contacts"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"contacts-create","summary":"Create contact","description":"Adds a contact linked to an Organization.","tags":["Contacts"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactCreate"}}}}}},"/v1/contacts/{contactId}":{"get":{"operationId":"contact-get","summary":"Get contact","description":"Returns a single contact.","tags":["Contacts"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"contactId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:read"]}]},"patch":{"operationId":"contact-update","summary":"Update contact","description":"Updates a contact's details or organization link.","tags":["Contacts"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"contactId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactPatch"}}}}},"delete":{"operationId":"contact-delete","summary":"Delete contact","description":"Removes a contact.","tags":["Contacts"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"contactId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/notes":{"get":{"operationId":"notes-list","summary":"List notes","description":"Lists the caller's notes, optionally filtered by target via ?targetType & ?targetId.","tags":["Notes"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"notes-create","summary":"Create note","description":"Adds a free-text note attached to a polymorphic subject.","tags":["Notes"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteCreate"},"example":{"targetType":"application","targetId":"app_123","body":"Recruiter prefers a Tuesday call."}}}}}},"/v1/notes/{noteId}":{"patch":{"operationId":"note-update","summary":"Update note","description":"Edits a note's body. The subject anchor is immutable — delete and recreate to re-anchor.","tags":["Notes"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"noteId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotePatch"}}}}},"delete":{"operationId":"note-delete","summary":"Delete note","description":"Removes a note.","tags":["Notes"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"noteId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["applications:write"]}]}},"/v1/attachments":{"get":{"operationId":"attachments-list","summary":"List attachments","description":"Lists the caller's file attachments, optionally filtered by subject.","tags":["Attachments"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]},"post":{"operationId":"attachments-create","summary":"Create attachment","description":"Records metadata for a stored file (R2 reference) linked to an optional subject.","tags":["Attachments"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttachmentCreate"}}}}}},"/v1/events":{"get":{"operationId":"events-list","summary":"List events","description":"The caller-wide, append-only event feed: pipeline activity plus an attributed audit entry for every /v1 write.","tags":["Events"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["applications:read"]}]}},"/v1/operations":{"get":{"operationId":"operations-list","summary":"List operations","description":"Lists the caller's async operations, newest first.","tags":["Operations"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["operations:read"]}]}},"/v1/operations/{operationId}":{"get":{"operationId":"operation-get","summary":"Get operation","description":"Returns the status and result references for an async operation.","tags":["Operations"],"responses":{"200":{"description":"Success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationResponse"}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"operationId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["operations:read"]}]}},"/v1/imports":{"post":{"operationId":"import-create","summary":"Import career data","description":"Parses a resume, plaintext, narrative, or JSON Resume into a reviewable change-set — nothing touches the profile until :apply. The onboarding entry point: when me.profileReadiness is not ready, import the user's existing resume here first.","tags":["Imports"],"responses":{"200":{"description":"Returns Operation."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:import","profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportRequest"},"example":{"source":"plaintext","content":"Senior Backend Engineer at Acme Corp (2021–present)…"}}}}},"get":{"operationId":"imports-list","summary":"List imports","description":"Lists the caller's imports, newest first.","tags":["Imports"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:import"]}]}},"/v1/imports:upload":{"post":{"operationId":"import-upload","summary":"Request import file upload","description":"Returns a presigned upload URL + fileKey for a resume file, for callers that cannot extract text themselves.","tags":["Imports"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["profile:import"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportUploadRequest"},"example":{"contentType":"application/pdf","sizeBytes":245760}}}}}},"/v1/imports/{importId}":{"get":{"operationId":"import-get","summary":"Get import change-set","description":"Returns an import with its proposed items (payload, dedup hints, per-item status) for review.","tags":["Imports"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"importId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:import"]}]}},"/v1/imports/{importId}:apply":{"post":{"operationId":"import-apply","summary":"Apply import items","description":"Rejects and/or applies proposed items; approved items write through the normal collection creates.","tags":["Imports"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"importId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["profile:import","profile:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportApplyRequest"},"example":{"itemIds":[],"rejectItemIds":[]}}}}}},"/v1/webhooks":{"get":{"operationId":"webhooks-list","summary":"List webhooks","description":"Lists the caller's registered webhook endpoints.","tags":["Webhooks"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["webhooks:manage"]}]},"post":{"operationId":"webhooks-create","summary":"Create webhook","description":"Registers an HTTPS endpoint that receives the caller's domain events, HMAC-signed.","tags":["Webhooks"],"responses":{"200":{"description":"Success."},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"bad_request","message":"Invalid request","issues":{"fieldName":["This field is required."]}}}}}},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"409":{"description":"Conflicting state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"conflict","message":"Conflicting state"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"security":[{"oauth2":["webhooks:manage"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreate"},"example":{"url":"https://example.com/hooks/resumez","eventTypes":["application.","operation."]}}}}}},"/v1/webhooks/{webhookId}":{"delete":{"operationId":"webhook-delete","summary":"Delete webhook","description":"Removes a webhook endpoint.","tags":["Webhooks"],"responses":{"200":{"description":"Success."},"401":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"unauthorized","message":"Authentication required"}}}}},"402":{"description":"Upgrade required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"upgrade_required","message":"Upgrade required","feature":"developerApi","featureLabel":"Developer API (OAuth clients)","currentPlan":"free","requiredPlan":"developer","remedy":"This capability requires the Developer plan. Consumer career tools over the MCP connector stay free — only the raw API (PATs / direct-REST OAuth), the MCP `api_request` escape hatch, and webhook management need it. Tell the user to upgrade at `upgradeUrl`; do not retry until they have.","upgradeUrl":"https://resumez.ai/#pricing"}}}}},"403":{"description":"Insufficient scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"forbidden","message":"Insufficient scope"}}}}},"404":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"error":{"code":"not_found","message":"Resource not found"}}}}}},"x-resumez-status":"implemented","x-resumez-progress":100,"parameters":[{"name":"webhookId","in":"path","required":true,"schema":{"type":"string"}}],"security":[{"oauth2":["webhooks:manage"]}]}}},"components":{"schemas":{"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","unauthorized","upgrade_required","forbidden","not_found","conflict","profile_incomplete","rate_limited","endpoint_not_found","not_implemented","internal_error","service_unavailable"],"description":"Stable, machine-readable error code from the Resumez error catalog."},"message":{"type":"string","description":"Human-readable explanation. Not for programmatic branching."}},"additionalProperties":true}}},"OrganizationUpsert":{"type":"object","properties":{"name":{"type":"string","minLength":1},"domain":{"type":"string"},"industry":{"type":"string"},"websiteUrl":{"type":"string","format":"uri"}},"required":["name"],"$schema":"http://json-schema.org/draft-07/schema#"},"SkillUpsert":{"type":"object","properties":{"name":{"type":"string","minLength":1},"category":{"type":"string"},"parentSkillId":{"type":"string"}},"required":["name"],"$schema":"http://json-schema.org/draft-07/schema#"},"CareerProfilePatch":{"type":"object","properties":{"headline":{"type":"string"},"location":{"type":"string"},"summary":{"type":"string"},"phone":{"type":"string"},"links":{"type":"object","properties":{"linkedin":{"type":"string","format":"uri"},"github":{"type":"string","format":"uri"},"portfolio":{"type":"string","format":"uri"}},"required":[]},"visibility":{"enum":["public","private","unlisted"],"type":"string"}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"ExperienceCreate":{"type":"object","properties":{"type":{"enum":["work","education","project","volunteer"],"type":"string"},"title":{"type":"string","minLength":1},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"startDate":{"type":"string"},"endDate":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"externalRef":{"type":"string","minLength":1}},"required":["type","title","organization","startDate"],"$schema":"http://json-schema.org/draft-07/schema#"},"ExperienceBatchCreate":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"type":{"enum":["work","education","project","volunteer"],"type":"string"},"title":{"type":"string","minLength":1},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"startDate":{"type":"string"},"endDate":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"externalRef":{"type":"string","minLength":1}},"required":["type","title","organization","startDate"]},"minItems":1,"maxItems":50}},"required":["items"],"$schema":"http://json-schema.org/draft-07/schema#"},"ExperiencePatch":{"type":"object","properties":{"type":{"enum":["work","education","project","volunteer"],"type":"string"},"title":{"type":"string","minLength":1},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"startDate":{"type":"string"},"endDate":{"type":"string"},"highlights":{"type":"array","items":{"type":"string"}},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"EducationCreate":{"type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"degree":{"type":"string"},"fieldOfStudy":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"}},"required":["organization"],"$schema":"http://json-schema.org/draft-07/schema#"},"EducationBatchCreate":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"degree":{"type":"string"},"fieldOfStudy":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"}},"required":["organization"]},"minItems":1,"maxItems":50}},"required":["items"],"$schema":"http://json-schema.org/draft-07/schema#"},"EducationPatch":{"type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"degree":{"type":"string"},"fieldOfStudy":{"type":"string"},"startDate":{"type":"string"},"endDate":{"type":"string"}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"ProjectCreate":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"externalRef":{"type":"string","minLength":1}},"required":["name"],"$schema":"http://json-schema.org/draft-07/schema#"},"ProjectBatchCreate":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"externalRef":{"type":"string","minLength":1}},"required":["name"]},"minItems":1,"maxItems":50}},"required":["items"],"$schema":"http://json-schema.org/draft-07/schema#"},"ProjectPatch":{"type":"object","properties":{"name":{"type":"string","minLength":1},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"AchievementCreate":{"type":"object","properties":{"title":{"type":"string","minLength":1},"metric":{"type":"string"},"evidenceUrl":{"type":"string","format":"uri"},"experienceId":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"externalRef":{"type":"string","minLength":1}},"required":["title"],"$schema":"http://json-schema.org/draft-07/schema#"},"AchievementBatchCreate":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","minLength":1},"metric":{"type":"string"},"evidenceUrl":{"type":"string","format":"uri"},"experienceId":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"externalRef":{"type":"string","minLength":1}},"required":["title"]},"minItems":1,"maxItems":50}},"required":["items"],"$schema":"http://json-schema.org/draft-07/schema#"},"AchievementPatch":{"type":"object","properties":{"title":{"type":"string","minLength":1},"metric":{"type":"string"},"evidenceUrl":{"type":"string","format":"uri"},"experienceId":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"SkillClaimCreate":{"type":"object","properties":{"skill":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]},"proficiency":{"enum":["beginner","intermediate","advanced","expert"],"type":"string"},"yearsOfExperience":{"type":"number"},"evidenceUrl":{"type":"string","format":"uri"}},"required":["skill"],"$schema":"http://json-schema.org/draft-07/schema#"},"SkillClaimBatchCreate":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"skill":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]},"proficiency":{"enum":["beginner","intermediate","advanced","expert"],"type":"string"},"yearsOfExperience":{"type":"number"},"evidenceUrl":{"type":"string","format":"uri"}},"required":["skill"]},"minItems":1,"maxItems":50}},"required":["items"],"$schema":"http://json-schema.org/draft-07/schema#"},"SkillClaimPatch":{"type":"object","properties":{"proficiency":{"enum":["beginner","intermediate","advanced","expert"],"type":"string"},"yearsOfExperience":{"type":"number"},"evidenceUrl":{"type":"string","format":"uri"}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"SnippetCreate":{"type":"object","properties":{"label":{"type":"string","minLength":1},"answer":{"type":"string","minLength":1},"matchers":{"type":"array","items":{"type":"string","minLength":1}}},"required":["label","answer"],"$schema":"http://json-schema.org/draft-07/schema#"},"SnippetPatch":{"type":"object","properties":{"label":{"type":"string","minLength":1},"answer":{"type":"string","minLength":1},"matchers":{"type":"array","items":{"type":"string","minLength":1}}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"ArtifactPatch":{"type":"object","properties":{"title":{"type":"string","minLength":1},"content":{"type":"string"},"contentType":{"type":"string"}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"ArtifactGenerationRequest":{"type":"object","properties":{"kind":{"enum":["resume","cover-letter","bio","recruiter-brief"],"type":"string"},"targetRole":{"type":"string"},"jobId":{"type":"string"},"jobDescription":{"type":"string"}},"required":["kind"],"$schema":"http://json-schema.org/draft-07/schema#"},"ArtifactFileExportRequest":{"type":"object","properties":{"format":{"enum":["pdf","json","txt"],"type":"string"}},"required":["format"],"$schema":"http://json-schema.org/draft-07/schema#"},"ArtifactExportRequest":{"type":"object","properties":{"format":{"enum":["pdf","docx","html","markdown","json-resume","ats-text"],"type":"string"}},"required":["format"],"$schema":"http://json-schema.org/draft-07/schema#"},"JobCreate":{"type":"object","properties":{"title":{"type":"string","minLength":1},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"jobDescription":{"type":"string","maxLength":30000},"location":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"salary":{"type":"string","minLength":1},"postedAt":{"type":"string","format":"date"},"sourceUrl":{"type":"string","maxLength":2000,"pattern":"^\\S+$","format":"uri"},"provenance":{"type":"object","properties":{"sourceTitle":{"type":"string","maxLength":500},"captureMethod":{"enum":["url","dom-text","screenshot","selection","batch"],"type":"string"},"clientName":{"const":"extension"},"clientVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]*$"},"capturedAt":{"type":"integer","minimum":0}},"required":["captureMethod","clientName","clientVersion","capturedAt"],"additionalProperties":false}},"required":["title"],"$schema":"http://json-schema.org/draft-07/schema#"},"JobPatch":{"type":"object","properties":{"title":{"type":"string","minLength":1},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"jobDescription":{"type":"string","maxLength":30000},"location":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"salary":{"type":"string"},"postedAt":{"type":"string"},"sourceUrl":{"type":"string","maxLength":2000,"pattern":"^\\S+$","format":"uri"},"provenance":{"type":"object","properties":{"sourceTitle":{"type":"string","maxLength":500},"captureMethod":{"enum":["url","dom-text","screenshot","selection","batch"],"type":"string"},"clientName":{"const":"extension"},"clientVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]*$"},"capturedAt":{"type":"integer","minimum":0}},"required":["captureMethod","clientName","clientVersion","capturedAt"],"additionalProperties":false}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"JobParseRequest":{"type":"object","properties":{"jobDescription":{"type":"string","minLength":1,"maxLength":30000},"sourceUrl":{"type":"string","maxLength":2000,"pattern":"^\\S+$","format":"uri"},"provenance":{"type":"object","properties":{"sourceTitle":{"type":"string","maxLength":500},"captureMethod":{"enum":["url","dom-text","screenshot","selection","batch"],"type":"string"},"clientName":{"const":"extension"},"clientVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]*$"},"capturedAt":{"type":"integer","minimum":0}},"required":["captureMethod","clientName","clientVersion","capturedAt"],"additionalProperties":false}},"required":["jobDescription"],"$schema":"http://json-schema.org/draft-07/schema#"},"JobParseScreenshotRequest":{"type":"object","properties":{"dataBase64":{"type":"string","minLength":1,"maxLength":2666672},"sourceUrl":{"type":"string","maxLength":2000,"pattern":"^\\S+$","format":"uri"},"provenance":{"type":"object","properties":{"sourceTitle":{"type":"string","maxLength":500},"captureMethod":{"enum":["url","dom-text","screenshot","selection","batch"],"type":"string"},"clientName":{"const":"extension"},"clientVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]*$"},"capturedAt":{"type":"integer","minimum":0}},"required":["captureMethod","clientName","clientVersion","capturedAt"],"additionalProperties":false}},"required":["dataBase64"],"$schema":"http://json-schema.org/draft-07/schema#"},"JobMatchRequest":{"type":"object","properties":{"artifactId":{"type":"string","minLength":1},"artifactVersion":{"type":"integer","minimum":1}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"ApplicationCreate":{"type":"object","properties":{"jobId":{"type":"string"},"job":{"type":"object","properties":{"title":{"type":"string","minLength":1},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"jobDescription":{"type":"string","maxLength":30000},"location":{"type":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":[]}},"salary":{"type":"string","minLength":1},"postedAt":{"type":"string","format":"date"},"sourceUrl":{"type":"string","maxLength":2000,"pattern":"^\\S+$","format":"uri"},"provenance":{"type":"object","properties":{"sourceTitle":{"type":"string","maxLength":500},"captureMethod":{"enum":["url","dom-text","screenshot","selection","batch"],"type":"string"},"clientName":{"const":"extension"},"clientVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]*$"},"capturedAt":{"type":"integer","minimum":0}},"required":["captureMethod","clientName","clientVersion","capturedAt"],"additionalProperties":false}},"required":["title"]},"source":{"type":"string"},"stage":{"enum":["saved","applied","screening","interviewing","offer","accepted","rejected","withdrawn"],"type":"string"}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"SubmissionCreate":{"type":"object","properties":{"channel":{"enum":["email","ats","referral","portal"],"type":"string"},"artifactVersionIds":{"type":"array","items":{"type":"string"}},"recipientContactId":{"type":"string"},"confirmationId":{"type":"string"},"idempotencyKey":{"type":"string"}},"required":["channel","artifactVersionIds"],"$schema":"http://json-schema.org/draft-07/schema#"},"InterviewCreate":{"type":"object","properties":{"applicationId":{"type":"string"},"application":{"type":"object","properties":{"title":{"type":"string","minLength":1},"company":{"type":"string","minLength":1},"sourceUrl":{"type":"string","maxLength":2000,"pattern":"^\\S+$","format":"uri"},"source":{"type":"string"}},"required":["title"]},"kind":{"enum":["phone","video","technical","onsite","panel"],"type":"string"},"scheduledAt":{"type":"number"},"location":{"type":"string"},"interviewerContactIds":{"type":"array","items":{"type":"string"}}},"required":["kind","scheduledAt"],"$schema":"http://json-schema.org/draft-07/schema#"},"InterviewPatch":{"type":"object","properties":{"kind":{"enum":["phone","video","technical","onsite","panel"],"type":"string"},"scheduledAt":{"type":"number"},"location":{"type":"string"},"status":{"enum":["completed","no_show"],"type":"string"},"outcome":{"type":"string"},"interviewerContactIds":{"type":"array","items":{"type":"string"}}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"OfferCreate":{"type":"object","properties":{"applicationId":{"type":"string"},"baseCompensation":{"type":"number"},"currency":{"type":"string"},"deadlineAt":{"type":"number"},"notes":{"type":"string"}},"required":["applicationId"],"$schema":"http://json-schema.org/draft-07/schema#"},"ReminderCreate":{"type":"object","properties":{"title":{"type":"string","minLength":1},"dueAt":{"type":"number"},"targetType":{"enum":["application","interview","offer","contact","job"],"type":"string"},"targetId":{"type":"string"}},"required":["title","dueAt"],"$schema":"http://json-schema.org/draft-07/schema#"},"ReminderPatch":{"type":"object","properties":{"title":{"type":"string","minLength":1},"dueAt":{"type":"number"},"targetType":{"enum":["application","interview","offer","contact","job"],"type":"string"},"targetId":{"type":"string"}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"ReminderSnoozeRequest":{"type":"object","properties":{"dueAt":{"type":"number"},"minutes":{"type":"number","minimum":1}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"ContactCreate":{"type":"object","properties":{"name":{"type":"string","minLength":1},"role":{"type":"string"},"email":{"type":"string","format":"email"},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"linkedinUrl":{"type":"string","format":"uri"}},"required":["name"],"$schema":"http://json-schema.org/draft-07/schema#"},"ContactPatch":{"type":"object","properties":{"name":{"type":"string","minLength":1},"role":{"type":"string"},"email":{"type":"string","format":"email"},"organization":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"}},"required":[]},"linkedinUrl":{"type":"string","format":"uri"}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"NoteCreate":{"type":"object","properties":{"targetType":{"enum":["application","interview","offer","contact","job","submission"],"type":"string"},"targetId":{"type":"string","minLength":1},"body":{"type":"string","minLength":1}},"required":["targetType","targetId","body"],"$schema":"http://json-schema.org/draft-07/schema#"},"NotePatch":{"type":"object","properties":{"body":{"type":"string","minLength":1}},"required":["body"],"$schema":"http://json-schema.org/draft-07/schema#"},"AttachmentCreate":{"type":"object","properties":{"fileName":{"type":"string","minLength":1},"contentType":{"type":"string"},"url":{"type":"string","format":"uri"},"targetType":{"enum":["application","interview","offer","contact","job","submission"],"type":"string"},"targetId":{"type":"string"}},"required":["fileName","contentType","url"],"$schema":"http://json-schema.org/draft-07/schema#"},"ImportRequest":{"type":"object","properties":{"source":{"enum":["resume","plaintext","json","narrative"],"type":"string"},"content":{"type":"string"},"fileKey":{"type":"string"}},"required":["source"],"$schema":"http://json-schema.org/draft-07/schema#"},"ImportUploadRequest":{"type":"object","properties":{"contentType":{"enum":["application/pdf"],"type":"string"},"sizeBytes":{"type":"integer","minimum":1,"maximum":10485760}},"required":["contentType","sizeBytes"],"$schema":"http://json-schema.org/draft-07/schema#"},"ImportApplyRequest":{"type":"object","properties":{"itemIds":{"type":"array","items":{"type":"string"}},"rejectItemIds":{"type":"array","items":{"type":"string"}}},"required":[],"$schema":"http://json-schema.org/draft-07/schema#"},"WebhookCreate":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"eventTypes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["url"],"$schema":"http://json-schema.org/draft-07/schema#"},"ApplicationLookupResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"application":{"type":"object","properties":{"id":{"type":"string"},"stage":{"type":"string"},"onHold":{"type":"boolean"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"job":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]},{"type":"null"}]},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","organization","_links"]},{"type":"null"}]},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","stage","onHold","source","job","updatedAt","_links"]},"matchedBy":{"type":"array","items":{"enum":["sourceUrl","company","title"],"type":"string"}},"confidence":{"enum":["strong","likely","possible"],"type":"string"}},"required":["application","matchedBy","confidence"]}}},"required":["data"],"$schema":"http://json-schema.org/draft-07/schema#"},"ApplicationResponse":{"type":"object","properties":{"id":{"type":"string"},"stage":{"type":"string"},"onHold":{"type":"boolean"},"source":{"anyOf":[{"type":"string"},{"type":"null"}]},"job":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]},{"type":"null"}]},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","organization","_links"]},{"type":"null"}]},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","stage","onHold","source","job","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"ArtifactResponse":{"type":"object","properties":{"id":{"type":"string"},"kind":{"enum":["resume","cover-letter","bio","recruiter-brief"],"type":"string"},"title":{"type":"string"},"contentType":{"type":"string"},"content":{"type":"string"},"currentVersion":{"type":"number"},"job":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","_links"]},{"type":"null"}]},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","kind","title","contentType","content","currentVersion","job","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"CareerProfileResponse":{"type":"object","properties":{"id":{"type":"string"},"identity":{"type":"object","properties":{"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["email","name"]},"headline":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"summary":{"anyOf":[{"type":"string"},{"type":"null"}]},"phone":{"anyOf":[{"type":"string"},{"type":"null"}]},"links":{"type":"object","properties":{"linkedin":{"anyOf":[{"type":"string"},{"type":"null"}]},"github":{"anyOf":[{"type":"string"},{"type":"null"}]},"portfolio":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["linkedin","github","portfolio"]},"visibility":{"anyOf":[{"enum":["public","private","unlisted"],"type":"string"},{"type":"null"}]},"counts":{"type":"object","properties":{"experiences":{"type":"number"},"educations":{"type":"number"},"projects":{"type":"number"},"skills":{"type":"number"},"achievements":{"type":"number"}},"required":["experiences","educations","projects","skills","achievements"]},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"_embedded":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["id","identity","headline","location","summary","phone","links","visibility","counts","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"EducationResponse":{"type":"object","properties":{"id":{"type":"string"},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]},{"type":"null"}]},"degree":{"anyOf":[{"type":"string"},{"type":"null"}]},"fieldOfStudy":{"anyOf":[{"type":"string"},{"type":"null"}]},"startDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"endDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"number"}},"required":["id","organization","degree","fieldOfStudy","startDate","endDate","updatedAt"],"$schema":"http://json-schema.org/draft-07/schema#"},"ExperienceResponse":{"type":"object","properties":{"id":{"type":"string"},"type":{"enum":["work","education","project","volunteer"],"type":"string"},"title":{"type":"string"},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]},{"type":"null"}]},"startDate":{"type":"string"},"endDate":{"anyOf":[{"type":"string"},{"type":"null"}]},"highlights":{"type":"array","items":{"type":"string"}},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]}},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","type","title","organization","startDate","endDate","highlights","skills","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"InterviewResponse":{"type":"object","properties":{"id":{"type":"string"},"kind":{"enum":["phone","video","technical","onsite","panel"],"type":"string"},"status":{"enum":["scheduled","completed","canceled","no_show"],"type":"string"},"scheduledAt":{"type":"number"},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}]},"application":{"type":"object","properties":{"id":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","_links"]},"interviewers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"}},"required":["id","display"]}},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","kind","status","scheduledAt","location","outcome","application","interviewers","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"JobGapAnalysisResponse":{"type":"object","properties":{"jobId":{"type":"string"},"missingSkills":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}}},"required":["jobId","missingSkills","recommendations"],"$schema":"http://json-schema.org/draft-07/schema#"},"JobMatchResponse":{"type":"object","properties":{"jobId":{"type":"string"},"score":{"anyOf":[{"type":"number"},{"type":"null"}]},"matched":{"type":"array","items":{"type":"string"}},"missing":{"type":"array","items":{"type":"string"}},"recommendations":{"type":"array","items":{"type":"string"}},"requiredCount":{"type":"number"},"profileSkillCount":{"type":"number"},"sourceSkillCount":{"type":"number"},"source":{"type":"object","properties":{"type":{"enum":["profile","artifact"],"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"type":"string"},"version":{"anyOf":[{"type":"number"},{"type":"null"}]},"hasUsableContent":{"type":"boolean"}},"required":["type","id","title","version","hasUsableContent"]}},"required":["jobId","score","matched","missing","recommendations","requiredCount","profileSkillCount","sourceSkillCount","source"],"$schema":"http://json-schema.org/draft-07/schema#"},"JobResponse":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"organization":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]},{"type":"null"}]},"role":{"anyOf":[{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]},{"type":"null"}]},"jobDescription":{"anyOf":[{"type":"string"},{"type":"null"}]},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"salary":{"anyOf":[{"type":"string"},{"type":"null"}]},"postedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"provenance":{"anyOf":[{"type":"object","properties":{"sourceTitle":{"type":"string","maxLength":500},"captureMethod":{"enum":["url","dom-text","screenshot","selection","batch"],"type":"string"},"clientName":{"const":"extension"},"clientVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]*$"},"capturedAt":{"type":"integer","minimum":0}},"required":["captureMethod","clientName","clientVersion","capturedAt"],"additionalProperties":false},{"type":"null"}]},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"display":{"type":"string"},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]}},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","title","organization","role","jobDescription","location","salary","postedAt","sourceUrl","skills","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"MeResponse":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"kind":{"enum":["session","oauth_user","oauth_client","pat"],"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"profileReadiness":{"type":"object","properties":{"status":{"enum":["ready","partial","empty"],"type":"string"},"missingRequired":{"type":"array","items":{"type":"string"}},"suggestedOptional":{"type":"array","items":{"type":"string"}},"remediation":{"type":"array","items":{"type":"object","properties":{"item":{"type":"string"},"requirement":{"enum":["required","optional"],"type":"string"},"method":{"type":"string"},"endpoint":{"type":"string"},"tool":{"type":"string"},"field":{"type":"string"},"note":{"type":"string"}},"required":["item","requirement"]}}},"required":["status","missingRequired","suggestedOptional","remediation"]},"beta":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"]}},"required":["id","email","kind","scopes","profileReadiness"],"$schema":"http://json-schema.org/draft-07/schema#"},"OperationResponse":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"status":{"enum":["pending","running","succeeded","failed"],"type":"string"},"result":{"anyOf":[{"type":"object","properties":{"resourceType":{"type":"string"},"id":{"type":"string"}},"required":["resourceType","id"]},{"type":"null"}]},"resultData":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceName":{"anyOf":[{"type":"string"},{"type":"null"}]},"provenance":{"anyOf":[{"type":"object","properties":{"sourceTitle":{"type":"string","maxLength":500},"captureMethod":{"enum":["url","dom-text","screenshot","selection","batch"],"type":"string"},"clientName":{"const":"extension"},"clientVersion":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9A-Za-z][0-9A-Za-z.+_-]*$"},"capturedAt":{"type":"integer","minimum":0}},"required":["captureMethod","clientName","clientVersion","capturedAt"],"additionalProperties":false},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","kind","status","result","resultData","error","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"ResumeExportDownloadResponse":{"type":"object","properties":{"id":{"type":"string"},"format":{"enum":["pdf","json","txt"],"type":"string"},"resumeTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"artifactId":{"anyOf":[{"type":"string"},{"type":"null"}]},"artifactVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"url":{"type":"string"},"expiresAt":{"type":"number"}},"required":["id","format","resumeTitle","artifactId","artifactVersion","url","expiresAt"],"$schema":"http://json-schema.org/draft-07/schema#"},"ResumeExportResponse":{"type":"object","properties":{"id":{"type":"string"},"format":{"enum":["pdf","json","txt"],"type":"string"},"contentType":{"type":"string"},"byteSize":{"type":"number"},"resumeTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"artifactId":{"anyOf":[{"type":"string"},{"type":"null"}]},"artifactVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"createdAt":{"type":"number"},"_links":{"type":"object","properties":{"download":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["download"]}},"required":["id","format","contentType","byteSize","resumeTitle","artifactId","artifactVersion","createdAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"},"SkillClaimResponse":{"type":"object","properties":{"id":{"type":"string"},"proficiency":{"anyOf":[{"type":"string"},{"type":"null"}]},"yearsOfExperience":{"anyOf":[{"type":"number"},{"type":"null"}]},"evidenceUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"number"},"skill":{"type":"object","properties":{"id":{"type":"string"},"display":{"anyOf":[{"type":"string"},{"type":"null"}]},"_links":{"type":"object","properties":{"self":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}},"required":["self"]}},"required":["id","display","_links"]}},"required":["id","proficiency","yearsOfExperience","evidenceUrl","updatedAt","skill"],"$schema":"http://json-schema.org/draft-07/schema#"},"SnippetDeleteResponse":{"type":"object","properties":{"deleted":{"type":"boolean"}},"required":["deleted"],"$schema":"http://json-schema.org/draft-07/schema#"},"SnippetResponse":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"answer":{"type":"string"},"matchers":{"type":"array","items":{"type":"string"}},"updatedAt":{"type":"number"},"_links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"object","properties":{"href":{"type":"string"},"method":{"type":"string"}},"required":["href","method"]}}},"required":["id","label","answer","matchers","updatedAt","_links"],"$schema":"http://json-schema.org/draft-07/schema#"}},"securitySchemes":{"oauth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://app.resumez.ai/auth/oauth2/authorize","tokenUrl":"https://app.resumez.ai/auth/oauth2/token","refreshUrl":"https://app.resumez.ai/auth/oauth2/token","scopes":{"ai:generate":"Run AI generation on your behalf.","applications:read":"Read your tracked job applications and pipeline activity.","applications:write":"Create or modify your tracked job applications and pipeline activity.","artifacts:export":"Export your artifacts and profile data.","artifacts:read":"Read your generated artifacts.","artifacts:write":"Create or edit your artifacts.","catalog:read":"Read shared catalogs (organizations, skills, roles).","catalog:write":"Find-or-create shared catalog entries.","jobs:analyze":"Parse and analyze job descriptions.","operations:read":"Read async operation status and results.","profile:import":"Import data into your canonical career profile.","profile:read":"Read your canonical career profile.","profile:write":"Modify your canonical career profile.","snippets:read":"Read your saved application answers.","snippets:write":"Create or modify your saved application answers.","webhooks:manage":"Manage webhook subscriptions."}}}}}}}