{
"error": {
"code": "AGREEMENT_OUTDATED",
"message": "Your organization must accept the current terms in the Sorce dashboard before publishing via the API."
}
}
DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.
{
"error": {
"code": "AGREEMENT_OUTDATED",
"message": "Your organization must accept the current terms in the Sorce dashboard before publishing via the API."
}
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sorce API","description":"Partner API for managing your company's jobs on Sorce.","colors":{"primary":"#2E9E5B","light":"#50C878","dark":"#2E9E5B"},"logo":{"light":"https://mintcdn.com/sorce/OVZekrRhi2WsWG5w/logo/sorce.svg?fit=max\u0026auto=format\u0026n=OVZekrRhi2WsWG5w\u0026q=85\u0026s=0ac7391ee89e19c7d9bd4e607d22d86e","dark":"https://mintcdn.com/sorce/OVZekrRhi2WsWG5w/logo/sorce.svg?fit=max\u0026auto=format\u0026n=OVZekrRhi2WsWG5w\u0026q=85\u0026s=0ac7391ee89e19c7d9bd4e607d22d86e"},"favicon":"https://mintcdn.com/sorce/OVZekrRhi2WsWG5w/favicon.svg?fit=max\u0026auto=format\u0026n=OVZekrRhi2WsWG5w\u0026q=85\u0026s=35435581cc7b900a96edaccab0bbd18b","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"href":"https://www.sorce.jobs/employer","label":"Sorce for Employers"}]},"footer":{"socials":{"website":"https://www.sorce.jobs"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sorce","hasAudioNarration":false,"actualSubdomain":"sorce","customDomains":["docs.sorce.jobs"],"gitSource":{"type":"github","owner":"swype-inc","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a32d83dc87f84e3c1e82c26","collectionId":"f8722953-d276-41eb-9829-75cc1586f21a","schemaVersion":"v3"},"entitlements":{},"buildId":"6a32d83dc87f84e3c1e82c26:success","clientVersion":"0.0.4039","searchFilterCounts":[{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Jobs","count":7},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Guides","count":3},{"language":"default","tag":"Locations","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/jobs/publish-a-draft","slug":"/api-reference/jobs/publish-a-draft","pageMetadata":{"title":"Publish a draft","description":"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/publish","href":"/api-reference/jobs/publish-a-draft","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Publish a draft","description":"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/publish","href":"/api-reference/jobs/publish-a-draft","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Jobs"],"operationId":"publishJob","summary":"Publish a draft","description":"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\n","parameters":["461080f3-3572-4374-8fd9-9524e4b1745a"],"responses":{"200":"b6749f34-70d6-422e-aa3b-6421344a9518","401":"949ec2e7-b787-4c9f-9889-7bf386c6024d","402":"7bc64e86-3a66-4ac2-aeb5-67a4b52b8304","404":"277508b4-6502-4e0f-b18c-e0061ba0df52","409":"a5b54162-e9cd-4eb2-825f-6a10f537d380","422":"060c735c-5ca9-41fe-a84d-ebd570c469c6"},"method":"post","type":"path","servers":["2820740a-086c-4f7f-afbe-2e8073705468"],"security":["464e63a4-642e-40f2-bba7-bd940b480e51"],"path":"/jobs/{id}/publish","baseUrlOptions":["https://www.sorce.jobs/api/external/v1"],"title":"Publish a draft","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"461080f3-3572-4374-8fd9-9524e4b1745a":{"name":"id","in":"path","required":true,"schema":{"type":"integer","isRequired":true,"description":"The job's stable cross-service id (`svcAtsId`).","uniqueKey":"","typeLabel":"integer"},"description":"The job's stable cross-service id (`svcAtsId`)."}},"responses":{"b6749f34-70d6-422e-aa3b-6421344a9518":{"description":"The job, now ACTIVE.","content":{"application/json":{"schema":{"type":"object","description":"The full job, as the dashboard sees it.","properties":{"id":{"type":"integer","description":"Stable cross-service job id (`svcAtsId`).","uniqueKey":"id","typeLabel":"integer"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"status":{"type":"string","enum":["DRAFT","ACTIVE","PAUSED","CLOSED","EXPIRED"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"remoteOption":{"oneOf":[{"type":"string","enum":["REMOTE","HYBRID","IN_PERSON",null],"uniqueKey":"remoteOption.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["REMOTE","HYBRID","IN_PERSON",null],"uniqueKey":"remoteOption.oneOf.1","typeLabel":"null"}],"uniqueKey":"remoteOption","typeLabel":"enum\u003cstring> | null"},"remoteCountry":{"oneOf":[{"type":"string","uniqueKey":"remoteCountry.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"remoteCountry.oneOf.1","typeLabel":"null"}],"uniqueKey":"remoteCountry","typeLabel":"string | null"},"jobType":{"oneOf":[{"type":"string","enum":["FULL_TIME","PART_TIME","CONTRACT","INTERNSHIP",null],"uniqueKey":"jobType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["FULL_TIME","PART_TIME","CONTRACT","INTERNSHIP",null],"uniqueKey":"jobType.oneOf.1","typeLabel":"null"}],"uniqueKey":"jobType","typeLabel":"enum\u003cstring> | null"},"jobLevel":{"oneOf":[{"type":"string","enum":["ENTRY","MID","SENIOR",null],"uniqueKey":"jobLevel.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["ENTRY","MID","SENIOR",null],"uniqueKey":"jobLevel.oneOf.1","typeLabel":"null"}],"uniqueKey":"jobLevel","typeLabel":"enum\u003cstring> | null"},"salaryMin":{"oneOf":[{"type":"integer","uniqueKey":"salaryMin.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"salaryMin.oneOf.1","typeLabel":"null"}],"uniqueKey":"salaryMin","typeLabel":"integer | null"},"salaryMax":{"oneOf":[{"type":"integer","uniqueKey":"salaryMax.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"salaryMax.oneOf.1","typeLabel":"null"}],"uniqueKey":"salaryMax","typeLabel":"integer | null"},"salaryPeriod":{"oneOf":[{"type":"string","enum":["ANNUAL","HOURLY",null],"uniqueKey":"salaryPeriod.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["ANNUAL","HOURLY",null],"uniqueKey":"salaryPeriod.oneOf.1","typeLabel":"null"}],"uniqueKey":"salaryPeriod","typeLabel":"enum\u003cstring> | null"},"bidPerQualifiedApplicantCents":{"oneOf":[{"type":"integer","uniqueKey":"bidPerQualifiedApplicantCents.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"bidPerQualifiedApplicantCents.oneOf.1","typeLabel":"null"}],"uniqueKey":"bidPerQualifiedApplicantCents","typeLabel":"integer | null"},"opportunityId":{"oneOf":[{"type":"string","description":"Partner id for this opening on the source ATS.","uniqueKey":"opportunityId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Partner id for this opening on the source ATS.","uniqueKey":"opportunityId.oneOf.1","typeLabel":"null"}],"uniqueKey":"opportunityId","typeLabel":"string | null"},"atsJobUrl":{"oneOf":[{"type":"string","format":"uri","description":"Canonical job URL on the source ATS.","uniqueKey":"atsJobUrl.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","description":"Canonical job URL on the source ATS.","uniqueKey":"atsJobUrl.oneOf.1","typeLabel":"null"}],"uniqueKey":"atsJobUrl","typeLabel":"string\u003curi> | null"},"companyId":{"type":"string","uniqueKey":"companyId","typeLabel":"string"},"locations":{"type":"array","items":{"type":"object","properties":{"locationId":{"type":"integer","example":17024,"uniqueKey":"locations.items.[INDEX].locationId","typeLabel":"integer"},"displayName":{"type":"string","example":"San Francisco, California, United States","uniqueKey":"locations.items.[INDEX].displayName","typeLabel":"string"},"city":{"type":"string","example":"San Francisco","uniqueKey":"locations.items.[INDEX].city","typeLabel":"string"},"stateProvince":{"type":"string","example":"California","uniqueKey":"locations.items.[INDEX].stateProvince","typeLabel":"string"},"country":{"type":"string","example":"United States","uniqueKey":"locations.items.[INDEX].country","typeLabel":"string"}},"uniqueKey":"locations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"locations","typeLabel":"object[]"},"qualifications":{"type":"array","items":{"type":"object","required":["text","kind","order"],"properties":{"text":{"type":"string","example":"5+ years of product design experience","isRequired":true,"uniqueKey":"qualifications.items.[INDEX].text","typeLabel":"string"},"kind":{"type":"string","enum":["REQUIRED","DESIRED"],"isRequired":true,"uniqueKey":"qualifications.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"order":{"type":"integer","example":0,"isRequired":true,"uniqueKey":"qualifications.items.[INDEX].order","typeLabel":"integer"},"id":{"type":"string","uniqueKey":"qualifications.items.[INDEX].id","typeLabel":"string"}},"uniqueKey":"qualifications.items.[INDEX]","typeLabel":"object"},"uniqueKey":"qualifications","typeLabel":"object[]"},"questions":{"type":"array","items":{"type":"object","description":"A custom screening question. Applicant basics (name, email, phone, location, resume) are collected automatically on every application and must not be sent as questions.\n","required":["prompt","answerFormat","order"],"properties":{"prompt":{"type":"string","example":"Why do you want to work here?","isRequired":true,"uniqueKey":"questions.items.[INDEX].prompt","typeLabel":"string"},"answerFormat":{"type":"string","enum":["TEXT","TEXTAREA","SINGLE_SELECT","MULTI_SELECT","NUMBER","FILE","DATE","SINGLE_CHECKBOX"],"description":"SINGLE_SELECT (pick exactly one option), MULTI_SELECT (pick one or more options), SINGLE_CHECKBOX (a single boolean toggle), and the freeform/typed formats (TEXT, TEXTAREA, NUMBER, FILE, DATE).\n","isRequired":true,"uniqueKey":"questions.items.[INDEX].answerFormat","typeLabel":"enum\u003cstring>"},"order":{"type":"integer","isRequired":true,"uniqueKey":"questions.items.[INDEX].order","typeLabel":"integer"},"options":{"type":"array","items":{"type":"string","uniqueKey":"questions.items.[INDEX].options.items.[INDEX]","typeLabel":"string"},"description":"For SINGLE_SELECT and MULTI_SELECT.","uniqueKey":"questions.items.[INDEX].options","typeLabel":"string[]"},"id":{"type":"string","uniqueKey":"questions.items.[INDEX].id","typeLabel":"string"}},"uniqueKey":"questions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"questions","typeLabel":"object[]"},"budgets":{"type":"array","items":{"type":"object","required":["window","budgetCents"],"properties":{"window":{"type":"string","enum":["DAILY","WEEKLY","MONTHLY","LIFETIME"],"isRequired":true,"uniqueKey":"budgets.items.[INDEX].window","typeLabel":"enum\u003cstring>"},"budgetCents":{"type":"integer","minimum":0,"example":50000,"isRequired":true,"uniqueKey":"budgets.items.[INDEX].budgetCents","typeLabel":"integer"},"notes":{"oneOf":[{"type":"string","uniqueKey":"budgets.items.[INDEX].notes.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"budgets.items.[INDEX].notes.oneOf.1","typeLabel":"null"}],"uniqueKey":"budgets.items.[INDEX].notes","typeLabel":"string | null"}},"uniqueKey":"budgets.items.[INDEX]","typeLabel":"object"},"uniqueKey":"budgets","typeLabel":"object[]"},"applicationCounts":{"type":"object","properties":{"pending":{"type":"integer","uniqueKey":"applicationCounts.pending","typeLabel":"integer"},"accepted":{"type":"integer","uniqueKey":"applicationCounts.accepted","typeLabel":"integer"},"rejected":{"type":"integer","uniqueKey":"applicationCounts.rejected","typeLabel":"integer"}},"uniqueKey":"applicationCounts","typeLabel":"object"},"isFrozen":{"type":"boolean","description":"True once the job has applications. Qualifications/questions locked.","uniqueKey":"isFrozen","typeLabel":"boolean"},"newApplicantCount":{"type":"integer","uniqueKey":"newApplicantCount","typeLabel":"integer"},"publishedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"publishedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"publishedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"publishedAt","typeLabel":"string\u003cdate-time> | null"},"expiresAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"expiresAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"expiresAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"expiresAt","typeLabel":"string\u003cdate-time> | null"},"closedAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"closedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"closedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"closedAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"title":"\u003cstring>","status":"DRAFT","description":"\u003cstring>","remoteOption":"REMOTE","remoteCountry":"\u003cstring>","jobType":"FULL_TIME","jobLevel":"ENTRY","salaryMin":123,"salaryMax":123,"salaryPeriod":"ANNUAL","bidPerQualifiedApplicantCents":123,"opportunityId":"\u003cstring>","atsJobUrl":"\u003cstring>","companyId":"\u003cstring>","locations":[{"locationId":17024,"displayName":"San Francisco, California, United States","city":"San Francisco","stateProvince":"California","country":"United States"}],"qualifications":[{"text":"5+ years of product design experience","kind":"REQUIRED","order":0,"id":"\u003cstring>"}],"questions":[{"prompt":"Why do you want to work here?","answerFormat":"TEXT","order":123,"options":["\u003cstring>"],"id":"\u003cstring>"}],"budgets":[{"window":"DAILY","budgetCents":50000,"notes":"\u003cstring>"}],"applicationCounts":{"pending":123,"accepted":123,"rejected":123},"isFrozen":true,"newApplicantCount":123,"publishedAt":"2023-11-07T05:31:56Z","expiresAt":"2023-11-07T05:31:56Z","closedAt":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"949ec2e7-b787-4c9f-9889-7bf386c6024d":{"description":"Missing, unknown, or revoked partner key.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INVALID_SERVICE_KEY","message":"Invalid service key."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_SERVICE_KEY","message":"Invalid service key."}}}},"exampleType":"examples"}},"exampleType":"examples"},"7bc64e86-3a66-4ac2-aeb5-67a4b52b8304":{"description":"A card on file is required before publishing.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"PAYMENT_METHOD_REQUIRED","message":"Add a payment method before publishing."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"PAYMENT_METHOD_REQUIRED","message":"Add a payment method before publishing."}}}},"exampleType":"examples"}},"exampleType":"examples"},"277508b4-6502-4e0f-b18c-e0061ba0df52":{"description":"No such job for this key (including other companies' jobs).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"NOT_FOUND","message":"Job not found."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"Job not found."}}}},"exampleType":"examples"}},"exampleType":"examples"},"a5b54162-e9cd-4eb2-825f-6a10f537d380":{"description":"Terms must be accepted in the dashboard before publishing.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"AGREEMENT_OUTDATED","message":"Your organization must accept the current terms in the Sorce dashboard before publishing via the API."}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AGREEMENT_OUTDATED","message":"Your organization must accept the current terms in the Sorce dashboard before publishing via the API."}}}},"exampleType":"examples"}},"exampleType":"examples"},"060c735c-5ca9-41fe-a84d-ebd570c469c6":{"description":"Bad input or incomplete listing; `fields` names each problem.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"fields":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"error.fields.additionalProperties","typeLabel":"string"},"uniqueKey":"error.fields","typeLabel":"object"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"VALIDATION_FAILED","message":"Validation failed.","fields":{"salaryMin":"Add a minimum salary."}}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"VALIDATION_FAILED","message":"Validation failed.","fields":{"salaryMin":"Add a minimum salary."}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"464e63a4-642e-40f2-bba7-bd940b480e51":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Partner key (`sk_ext_…`) bound to your company.","scopes":[]}}},"servers":{"2820740a-086c-4f7f-afbe-2e8073705468":{"url":"https://www.sorce.jobs/api/external/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Partner key (`sk_ext_…`) bound to your company.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Partner key (`sk_ext_…`) bound to your company.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"sorce","siteName":"Sorce API","title":"Publish a draft - Sorce API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-17T17:24:28.903Z","originalFileLocation":"api-reference/jobs/publish-a-draft.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sorce API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Publish a draft - Sorce API\">\u003cmeta data-mint-head property=\"og:description\" content=\"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sorce API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sorce.mintlify.app/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Publish+a+draft\u0026amp;description=DRAFT+%E2%86%92+ACTIVE.+Runs+the+three+publish+gates%3A+completeness+%28422+with+a+field+map%29%2C+terms+accepted+in+the+dashboard+%28409+AGREEMENT_OUTDATED%29%2C+and+a+card+on+file+\u0026amp;theme=15171b0aa3355c23bb6e912c\u0026amp;signature=704cce284d7f61501f3e14c828bf11991c584df3d4934b16655352bc8818fb17\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Publish a draft - Sorce API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sorce.mintlify.app/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Publish+a+draft\u0026amp;description=DRAFT+%E2%86%92+ACTIVE.+Runs+the+three+publish+gates%3A+completeness+%28422+with+a+field+map%29%2C+terms+accepted+in+the+dashboard+%28409+AGREEMENT_OUTDATED%29%2C+and+a+card+on+file+\u0026amp;theme=15171b0aa3355c23bb6e912c\u0026amp;signature=704cce284d7f61501f3e14c828bf11991c584df3d4934b16655352bc8818fb17\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/sorce/kBgTLu0ZeoS8okkp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sorce API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2E9E5B\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/jobs/publish-a-draft.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sorce.jobs/#organization\",\"name\":\"Sorce API\",\"url\":\"https://docs.sorce.jobs\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sorce/OVZekrRhi2WsWG5w/logo/sorce.svg?fit=max\u0026auto=format\u0026n=OVZekrRhi2WsWG5w\u0026q=85\u0026s=0ac7391ee89e19c7d9bd4e607d22d86e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sorce.jobs#website\",\"name\":\"Sorce API\",\"url\":\"https://docs.sorce.jobs\",\"publisher\":{\"@id\":\"https://docs.sorce.jobs/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft#webpage\",\"url\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft\",\"name\":\"Publish a draft\",\"description\":\"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\",\"dateModified\":\"2026-06-17T17:24:28.903Z\",\"isPartOf\":{\"@id\":\"https://docs.sorce.jobs#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.sorce.jobs/api-reference/locations/search-locations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Jobs\",\"item\":\"https://docs.sorce.jobs/api-reference/jobs/create-a-job\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Publish a draft\",\"item\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft#apireference\",\"headline\":\"Publish a draft\",\"name\":\"Publish a draft\",\"description\":\"DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.\",\"url\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sorce.jobs/api-reference/jobs/publish-a-draft#webpage\"},\"dateModified\":\"2026-06-17T17:24:28.903Z\",\"publisher\":{\"@id\":\"https://docs.sorce.jobs/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sorce.jobs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sorce API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sorce API","nav":{"global":null,"groups":[{"group":"Getting started","pages":[{"title":"Introduction","href":"/index"},{"title":"Authentication","href":"/authentication"},{"title":"Errors","href":"/errors"}]},{"group":"Guides","pages":[{"title":"Locations","href":"/guides/locations"},{"title":"Publishing","href":"/guides/publishing"},{"title":"Budgets","href":"/guides/budgets"}]},{"group":"API Reference","pages":[{"group":"Locations","pages":[{"title":"Search locations","deprecated":null,"version":null,"openapi":"/openapi.yaml get /locations/search","href":"/api-reference/locations/search-locations"}]},{"group":"Jobs","pages":[{"title":"Create a job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs","href":"/api-reference/jobs/create-a-job"},{"title":"Get a job","deprecated":null,"version":null,"openapi":"/openapi.yaml get /jobs/{id}","href":"/api-reference/jobs/get-a-job"},{"title":"Update a job","description":"Partial update; only the fields you send change. The arrays (`locations`, `qualifications`, `questions`, `budgets`) are replace-sets: what you send becomes the entire new set. Live (ACTIVE/PAUSED) jobs are re-validated after the patch and the whole change is rejected if it would leave the listing incomplete. Once a job has applications, `qualifications` and `questions` are frozen.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /jobs/{id}","href":"/api-reference/jobs/update-a-job"},{"title":"Publish a draft","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/publish","href":"/api-reference/jobs/publish-a-draft"},{"title":"Pause a job","description":"ACTIVE → PAUSED. The listing is hidden until resumed.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/pause","href":"/api-reference/jobs/pause-a-job"},{"title":"Resume a paused job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/resume","href":"/api-reference/jobs/resume-a-paused-job"},{"title":"Close a job","deprecated":null,"version":null,"openapi":"/openapi.yaml post /jobs/{id}/close","href":"/api-reference/jobs/close-a-job"}]}]}]},"basePath":"","title":"Publish a draft - Sorce API","buildId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","deploymentId":"dpl_77Hw7ZuAABM8E3WMbYAf2ohQCr3v","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CVpqyvFO.js","utils-vpweLD0v.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BIOodqb0.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B1LM3qmu.js","snippetPresets-C5xK0GtN.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CCsxLnQl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C2-WKG22.js","shallow-SdoLUC-q.js","getApiPlaygroundDisplay-BnI8L2hB.js","CodeSnippet-D5M8NCHI.js","CodeSnippets-CXRO8Uom.js","Page-CN9QbZiA.js","getPastedJson-CrfHEdRt.js","icon-Cr8AyUnW.js","MethodPill-J_Cs0kNw.js","DuplicateIcon-DrMboxGw.js","createIcon-B4CIWVbU.js","DynamicMarkdown-D9cdbgj9.js","SectionHeading-BO4CouT0.js","axios-vUo_bRtp.js","Markdown-L1m1-PSi.js","clsx-rIpTdK8h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-ptfS1uB_.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-D31Sm3f9.js"]}