{
"message": "Validation error. (and 3 more errors)",
"errors": {
"offers.0.price_per_step": [
"The offers.0.price_per_step field must be a number."
],
"offers.0.data.71": [
{
"error": "Invalid value for field: Rank",
"type": "string",
"allowed_values": [
"Challenger",
"Grandmaster",
"Master",
"Diamond",
"Silver",
"Bronze",
"Emerald",
"Platinum",
"Iron",
"Gold"
]
}
],
"offers.0.data.74": [
{
"error": "Invalid value for field: Leveling",
"type": "string",
"allowed_values": [
"Handmade",
"Automated"
]
}
]
}
}
{
"message": "Unauthorized"
}
{
"message": "Forbidden"
}
{
"message": "Rate limit exceeded: max 200 offers per minute.",
"budget_used": 180,
"budget_limit": 200,
"offers_requested": 50
}
Offers
Manage offer (create or edit with automatic status determination)
Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically.
*
Automatic status determination:
Gold marketplace: Always set to Active if validation passes
Account marketplace:
If data field validation fails → Need Details
If MULTIPLE credential system and no active credentials → Not Active
If all validations pass → On Review (for moderation)
Operation type (add/edit):
Operation type is determined automatically by presence of ‘id’ field in offer object
If ‘id’ is present → edit operation (only provided fields will be updated)
If ‘id’ is missing → add operation (all required fields must be provided)
Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.
POST
/
api
/
shop
/
marketplace
/
products
/
{productId}
/
offers
/
manage
Manage offer (create or edit with automatic status determination)
Array of offers to create or update. If an offer object contains 'id', it will be updated. If 'id' is missing, a new offer will be created. Maximum 100 offers per request.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"SkyCoach API Documentation","colors":{"primary":"#5A30FF","light":"#5A30FF","dark":"#5A30FF"},"favicon":"https://skycoach.gg/images/favicon/rebranded/1__192x192.png","logo":"https://skycoach.gg/images/logos/rebranded/logo.svg","appearance":{"default":"dark","strict":true},"background":{"decoration":null},"navbar":{"links":[{"label":"Support","href":"mailto:support@skycoach.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://skycoach.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"skycoachltd","hasAudioNarration":false,"actualSubdomain":"skycoachltd","customDomains":["api.skycoach.gg"],"gitSource":{"type":"github","owner":"skycoach-gg","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6acfa868a3835795edb6e932","collectionId":"a7c53f02-9572-43a8-adb0-b3e8b04f287e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acfa868a3835795edb6e932"},"entitlements":{},"buildId":"6acfa868a3835795edb6e932","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":21},{"language":"default","tag":"Offers","count":10},{"language":"default","tag":"Offer Credentials","count":7},{"language":"default","tag":"Documentation","count":3},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Currency Marketplace","count":2},{"language":"default","tag":"Offer Discount","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination","slug":"/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination","pageMetadata":{"title":"Manage offer (create or edit with automatic status determination)","description":"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically.\n *\n **Automatic status determination:**\n * - **Gold marketplace**: Always set to Active if validation passes\n * - **Account marketplace**:\n * - If data field validation fails → Need Details\n * - If MULTIPLE credential system and no active credentials → Not Active\n * - If all validations pass → On Review (for moderation)\n *\n **Operation type (add/edit):**\n * - Operation type is determined automatically by presence of 'id' field in offer object\n * - If 'id' is present → edit operation (only provided fields will be updated)\n * - If 'id' is missing → add operation (all required fields must be provided)\n *\n * Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.","deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/products/{productId}/offers/manage","href":"/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically.\\n*\\n\", _jsx(_components.strong, {\n children: \"Automatic status determination:\"\n })]\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"Gold marketplace\"\n }), \": Always set to Active if validation passes\"]\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.strong, {\n children: \"Account marketplace\"\n }), \":\"]\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"If data field validation fails → Need Details\"\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"If MULTIPLE credential system and no active credentials → Not Active\"\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"If all validations pass → On Review (for moderation)\"\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.li, {}), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Operation type (add/edit):\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Operation type is determined automatically by presence of ‘id’ field in offer object\"\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"If ‘id’ is present → edit operation (only provided fields will be updated)\"\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"If ‘id’ is missing → add operation (all required fields must be provided)\"\n }), \"\\n\"]\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.li, {}), \"\\n\", _jsx(_components.li, {\n children: \"Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.\"\n }), \"\\n\"]\n })]\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":"Manage offer (create or edit with automatic status determination)","description":"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically.\n *\n **Automatic status determination:**\n * - **Gold marketplace**: Always set to Active if validation passes\n * - **Account marketplace**:\n * - If data field validation fails → Need Details\n * - If MULTIPLE credential system and no active credentials → Not Active\n * - If all validations pass → On Review (for moderation)\n *\n **Operation type (add/edit):**\n * - Operation type is determined automatically by presence of 'id' field in offer object\n * - If 'id' is present → edit operation (only provided fields will be updated)\n * - If 'id' is missing → add operation (all required fields must be provided)\n *\n * Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.","deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/products/{productId}/offers/manage","href":"/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Offers"],"summary":"Manage offer (create or edit with automatic status determination)","description":"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically.\n *\n **Automatic status determination:**\n * - **Gold marketplace**: Always set to Active if validation passes\n * - **Account marketplace**:\n * - If data field validation fails → Need Details\n * - If MULTIPLE credential system and no active credentials → Not Active\n * - If all validations pass → On Review (for moderation)\n *\n **Operation type (add/edit):**\n * - Operation type is determined automatically by presence of 'id' field in offer object\n * - If 'id' is present → edit operation (only provided fields will be updated)\n * - If 'id' is missing → add operation (all required fields must be provided)\n *\n * Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.","operationId":"57638bf7ff98bce61d4830ee104bd885","parameters":["7f178809-84bf-4336-90ff-a718d6f7459a","c3be4ec2-6468-4b4c-bda5-3a3b7684dfd0"],"requestBody":"0df4cfba-008b-4b40-a166-bdc03cc3b105","responses":{"200":"9347c525-7d70-4199-8d3d-5e65c5f8802d","400":"991c70f7-43ce-4b35-b7fe-7123fe93e814","401":"363f5e66-e59d-4ea1-9240-cb28d6ff0ae2","403":"e10ab1a1-c455-40fe-b0bb-11c32db56355","429":"3676611d-6b8d-4701-922c-4bc82b889ee8"},"security":["162ad38a-2b4a-4e94-a971-126fd8afe228"],"method":"post","type":"path","servers":["82f0032c-9dd3-4724-9666-4279cce735b8"],"path":"/api/shop/marketplace/products/{productId}/offers/manage","baseUrlOptions":["https://skycoach.gg/"],"title":"Manage offer (create or edit with automatic status determination)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7f178809-84bf-4336-90ff-a718d6f7459a":{"name":"Accept","in":"header","description":"API response format","required":true,"schema":{"type":"string","default":"application/json","enum":["application/json"],"isRequired":true,"description":"API response format","uniqueKey":"","typeLabel":"enum\u003cstring>"}},"c3be4ec2-6468-4b4c-bda5-3a3b7684dfd0":{"name":"productId","in":"path","description":"Product currency marketplace ID","required":true,"schema":{"type":"integer","example":13,"isRequired":true,"description":"Product currency marketplace ID","uniqueKey":"","typeLabel":"integer"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"required":["offers","guarantee_delivery_time"],"properties":{"offers":{"description":"Array of offers to create or update. If an offer object contains 'id', it will be updated. If 'id' is missing, a new offer will be created. Maximum 100 offers per request.","type":"array","items":{"properties":{"id":{"oneOf":[{"description":"Offer ID. If provided, the offer will be updated. If missing, a new offer will be created.","type":"integer","example":335838,"uniqueKey":"offers.items.[INDEX].id.oneOf.0","typeLabel":"integer"},{"description":"Offer ID. If provided, the offer will be updated. If missing, a new offer will be created.","type":"null","example":335838,"uniqueKey":"offers.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].id","typeLabel":"integer | null"},"price_per_step":{"description":"Price per step. For account marketplace: minimum 0.1, maximum 2000000000. For gold marketplace: minimum 0.0001, maximum 2000000000","type":"number","format":"float","maximum":2000000000,"minimum":0.0001,"example":100,"uniqueKey":"offers.items.[INDEX].price_per_step","typeLabel":"number\u003cfloat>"},"amount":{"description":"Offer amount. For account marketplace: minimum 1, maximum 1. For gold marketplace: minimum 1, maximum 2000000000","type":"number","format":"float","maximum":2000000000,"minimum":1,"example":1,"uniqueKey":"offers.items.[INDEX].amount","typeLabel":"number\u003cfloat>"},"min_purchase_amount":{"description":"Minimum purchase amount. Must be >= product step_size. For account marketplace: minimum 1, maximum 1","type":"number","format":"float","maximum":2000000000,"minimum":1,"example":1,"uniqueKey":"offers.items.[INDEX].min_purchase_amount","typeLabel":"number\u003cfloat>"},"data":{"description":"Offer data object. Structure depends on product currency setting fields. Contains field values selected by the seller. All required fields must be provided and validated.\n *\n **To get the structure of this object:**\n *\n * 1. Get product details: GET /shop/marketplace/products/{productId}\n * 2. Check the product_fields array in the response\n * 3. Each field has:\n * - id - field ID (use as key in data object)\n * - title - field name\n * - is_required - whether field is required\n * - component_edit - field type (1=text, 2=select, etc.)\n * - field_values - available values for select fields\n *\n **Example data structure:**\n * - Key: field ID (from product_fields)\n * - Value: for select fields use value string from field_values (e.g. Grandmaster, not the ID), for text fields use actual text value\n *\n **Note:** Get the product details first to see which fields are required and what values are available.","type":"object","example":{"81":"Battle Royale","82":123},"uniqueKey":"offers.items.[INDEX].data","typeLabel":"object"},"marketplace_type":{"description":"Marketplace type. Must match the product type.\n *\n **Possible values:**\n * - **1** (Gold): Gold marketplace\n * - **2** (Account): Account marketplace","type":"integer","enum":[1,2],"example":2,"uniqueKey":"offers.items.[INDEX].marketplace_type","typeLabel":"enum\u003cinteger>"},"screenshots":{"oneOf":[{"description":"Array of screenshot URLs. Screenshots must be uploaded first using POST /shop/marketplace/offers/upload_screenshot (multipart/form-data). The returned URLs should be included in this array.","type":"array","items":{"type":"string","example":"storage/uploads/product_currency_offer/screenshot/example.jpg","uniqueKey":"offers.items.[INDEX].screenshots.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"offers.items.[INDEX].screenshots.oneOf.0","typeLabel":"string[]"},{"description":"Array of screenshot URLs. Screenshots must be uploaded first using POST /shop/marketplace/offers/upload_screenshot (multipart/form-data). The returned URLs should be included in this array.","type":"null","items":{"type":"string","example":"storage/uploads/product_currency_offer/screenshot/example.jpg"},"uniqueKey":"offers.items.[INDEX].screenshots.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].screenshots","typeLabel":"string[] | null"},"comment_for_reviewer":{"oneOf":[{"description":"Comment for reviewer","type":"string","example":"comment","uniqueKey":"offers.items.[INDEX].comment_for_reviewer.oneOf.0","typeLabel":"string"},{"description":"Comment for reviewer","type":"null","example":"comment","uniqueKey":"offers.items.[INDEX].comment_for_reviewer.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].comment_for_reviewer","typeLabel":"string | null"},"is_auto_activate_status":{"oneOf":[{"description":"Automatically activate status after review passes","type":"boolean","example":true,"uniqueKey":"offers.items.[INDEX].is_auto_activate_status.oneOf.0","typeLabel":"boolean"},{"description":"Automatically activate status after review passes","type":"null","example":true,"uniqueKey":"offers.items.[INDEX].is_auto_activate_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].is_auto_activate_status","typeLabel":"boolean | null"},"outer_name":{"oneOf":[{"description":"Outer name (for account marketplace only)","type":"string","maxLength":255,"example":"test offer","uniqueKey":"offers.items.[INDEX].outer_name.oneOf.0","typeLabel":"string"},{"description":"Outer name (for account marketplace only)","type":"null","maxLength":255,"example":"test offer","uniqueKey":"offers.items.[INDEX].outer_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].outer_name","typeLabel":"string | null"},"internal_name":{"oneOf":[{"description":"Internal name (for account marketplace only)","type":"string","maxLength":255,"example":"","uniqueKey":"offers.items.[INDEX].internal_name.oneOf.0","typeLabel":"string"},{"description":"Internal name (for account marketplace only)","type":"null","maxLength":255,"example":"","uniqueKey":"offers.items.[INDEX].internal_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].internal_name","typeLabel":"string | null"},"description":{"oneOf":[{"description":"Offer description (for account marketplace only)","type":"string","maxLength":650,"example":"description","uniqueKey":"offers.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"description":"Offer description (for account marketplace only)","type":"null","maxLength":650,"example":"description","uniqueKey":"offers.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].description","typeLabel":"string | null"},"credential_system_type_id":{"oneOf":[{"description":"Authoritative delivery-mode field. 1 = No Credentials (stock-mode), 2 = Single (deprecated — coerced to MULTIPLE on write), 3 = Multiple (credential-mode). Defaults to 3 on create.","type":"integer","enum":[1,2,3],"example":1,"uniqueKey":"offers.items.[INDEX].credential_system_type_id.oneOf.0","typeLabel":"enum\u003cinteger>"},{"description":"Authoritative delivery-mode field. 1 = No Credentials (stock-mode), 2 = Single (deprecated — coerced to MULTIPLE on write), 3 = Multiple (credential-mode). Defaults to 3 on create.","type":"null","enum":[1,2,3],"example":1,"uniqueKey":"offers.items.[INDEX].credential_system_type_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].credential_system_type_id","typeLabel":"enum\u003cinteger> | null"},"booster_price":{"oneOf":[{"description":"Booster price (for fake sellers in account marketplace only). Must be less than price_per_step","type":"number","format":"float","maximum":2000000000,"minimum":0.01,"example":80,"uniqueKey":"offers.items.[INDEX].booster_price.oneOf.0","typeLabel":"number\u003cfloat>"},{"description":"Booster price (for fake sellers in account marketplace only). Must be less than price_per_step","type":"null","format":"float","maximum":2000000000,"minimum":0.01,"example":80,"uniqueKey":"offers.items.[INDEX].booster_price.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].booster_price","typeLabel":"number\u003cfloat> | null"},"credentials":{"oneOf":[{"description":"Array of credentials (for account marketplace with credential system). Each credential object contains account login credentials.","type":"array","items":{"properties":{"email":{"oneOf":[{"description":"Registration email","type":"string","example":"123@test.com","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"description":"Registration email","type":"null","example":"123@test.com","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].email","typeLabel":"string | null"},"email_password":{"oneOf":[{"description":"Email password","type":"string","example":"123456789","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].email_password.oneOf.0","typeLabel":"string"},{"description":"Email password","type":"null","example":"123456789","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].email_password.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].email_password","typeLabel":"string | null"},"login":{"description":"Account login","type":"string","example":"login","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].login","typeLabel":"string"},"game_password":{"description":"Account password","type":"string","example":"987654321","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].game_password","typeLabel":"string"},"is_2fa_active":{"oneOf":[{"description":"Whether 2FA is active","type":"boolean","example":true,"uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].is_2fa_active.oneOf.0","typeLabel":"boolean"},{"description":"Whether 2FA is active","type":"null","example":true,"uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].is_2fa_active.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].is_2fa_active","typeLabel":"boolean | null"},"comment":{"oneOf":[{"description":"Comment from seller","type":"string","example":"comment","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].comment.oneOf.0","typeLabel":"string"},{"description":"Comment from seller","type":"null","example":"comment","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].comment.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX].comment","typeLabel":"string | null"}},"type":"object","uniqueKey":"offers.items.[INDEX].credentials.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"offers.items.[INDEX].credentials.oneOf.0","typeLabel":"object[]"},{"description":"Array of credentials (for account marketplace with credential system). Each credential object contains account login credentials.","type":"null","items":{"properties":{"email":{"oneOf":[{"description":"Registration email","type":"string","example":"123@test.com"},{"description":"Registration email","type":"null","example":"123@test.com"}]},"email_password":{"oneOf":[{"description":"Email password","type":"string","example":"123456789"},{"description":"Email password","type":"null","example":"123456789"}]},"login":{"description":"Account login","type":"string","example":"login"},"game_password":{"description":"Account password","type":"string","example":"987654321"},"is_2fa_active":{"oneOf":[{"description":"Whether 2FA is active","type":"boolean","example":true},{"description":"Whether 2FA is active","type":"null","example":true}]},"comment":{"oneOf":[{"description":"Comment from seller","type":"string","example":"comment"},{"description":"Comment from seller","type":"null","example":"comment"}]}},"type":"object"},"uniqueKey":"offers.items.[INDEX].credentials.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].credentials","typeLabel":"object[] | null"},"skycoach_price":{"oneOf":[{"description":"Skycoach price","type":"number","format":"float","example":null,"uniqueKey":"offers.items.[INDEX].skycoach_price.oneOf.0","typeLabel":"number\u003cfloat>"},{"description":"Skycoach price","type":"null","format":"float","example":null,"uniqueKey":"offers.items.[INDEX].skycoach_price.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].skycoach_price","typeLabel":"number\u003cfloat> | null"},"import_status":{"oneOf":[{"description":"Import status","type":"integer","example":1,"uniqueKey":"offers.items.[INDEX].import_status.oneOf.0","typeLabel":"integer"},{"description":"Import status","type":"null","example":1,"uniqueKey":"offers.items.[INDEX].import_status.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].import_status","typeLabel":"integer | null"},"search_description":{"oneOf":[{"description":"Search description for offer indexing","type":"string","example":"some text","uniqueKey":"offers.items.[INDEX].search_description.oneOf.0","typeLabel":"string"},{"description":"Search description for offer indexing","type":"null","example":"some text","uniqueKey":"offers.items.[INDEX].search_description.oneOf.1","typeLabel":"null"}],"uniqueKey":"offers.items.[INDEX].search_description","typeLabel":"string | null"}},"type":"object","uniqueKey":"offers.items.[INDEX]","typeLabel":"object"},"maxItems":100,"minItems":1,"isRequired":true,"uniqueKey":"offers","typeLabel":"object[]"},"guarantee_delivery_time":{"description":"Guaranteed delivery time in milliseconds (e.g., 86400000 for 24 hours)","type":"integer","minimum":1,"example":86400000,"isRequired":true,"uniqueKey":"guarantee_delivery_time","typeLabel":"integer"}},"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"offers":[{"price_per_step":2,"amount":1,"min_purchase_amount":"1","data":{"69":[],"70":[],"71":"Grandmaster","72":"Brazil","73":7005,"74":"Handmade","78":1,"204":200},"marketplace_type":2,"is_auto_activate_status":true,"outer_name":"LoL Account with Rare Skins","internal_name":"LoL_Account_001","description":"Account with Officer Vi and Pharaoh Amumu skins","credential_system_type_id":1,"search_description":"LoL account with rare skins"},{"id":336372,"price_per_step":2,"amount":1,"min_purchase_amount":"1","data":{"69":[],"70":[],"71":"Grandmaster","72":"Brazil","73":7005,"74":"Handmade","78":1,"204":200},"marketplace_type":2,"is_auto_activate_status":true,"outer_name":"LoL Account with Rare Skins","internal_name":"LoL_Account_001","description":"Account with Officer Vi and Pharaoh Amumu skins","credential_system_type_id":1,"search_description":"LoL account with rare skins"}],"guarantee_delivery_time":"1-2 hours"},"examples":{"Example":{"title":"Example","value":{"offers":[{"price_per_step":2,"amount":1,"min_purchase_amount":"1","data":{"69":[],"70":[],"71":"Grandmaster","72":"Brazil","73":7005,"74":"Handmade","78":1,"204":200},"marketplace_type":2,"is_auto_activate_status":true,"outer_name":"LoL Account with Rare Skins","internal_name":"LoL_Account_001","description":"Account with Officer Vi and Pharaoh Amumu skins","credential_system_type_id":1,"search_description":"LoL account with rare skins"},{"id":336372,"price_per_step":2,"amount":1,"min_purchase_amount":"1","data":{"69":[],"70":[],"71":"Grandmaster","72":"Brazil","73":7005,"74":"Handmade","78":1,"204":200},"marketplace_type":2,"is_auto_activate_status":true,"outer_name":"LoL Account with Rare Skins","internal_name":"LoL_Account_001","description":"Account with Officer Vi and Pharaoh Amumu skins","credential_system_type_id":1,"search_description":"LoL account with rare skins"}],"guarantee_delivery_time":"1-2 hours"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"9347c525-7d70-4199-8d3d-5e65c5f8802d":{"description":"Success","content":{"application/json":{"schema":{"properties":{"result":{"properties":{"message":{"type":"string","example":"ok","uniqueKey":"result.message","typeLabel":"string"},"received":{"description":"Total number of offers received in request","type":"integer","example":3,"uniqueKey":"result.received","typeLabel":"integer"},"successfully":{"description":"Number of offers successfully processed","type":"integer","example":2,"uniqueKey":"result.successfully","typeLabel":"integer"},"results":{"description":"Array of results for each offer","type":"array","items":{"properties":{"id":{"oneOf":[{"type":"integer","example":335838,"uniqueKey":"result.results.items.[INDEX].id.oneOf.0","typeLabel":"integer"},{"type":"null","example":335838,"uniqueKey":"result.results.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.results.items.[INDEX].id","typeLabel":"integer | null"},"status":{"type":"string","example":"ok","uniqueKey":"result.results.items.[INDEX].status","typeLabel":"string"},"message":{"oneOf":[{"type":"string","example":"Failed to process offer","uniqueKey":"result.results.items.[INDEX].message.oneOf.0","typeLabel":"string"},{"type":"null","example":"Failed to process offer","uniqueKey":"result.results.items.[INDEX].message.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.results.items.[INDEX].message","typeLabel":"string | null"}},"type":"object","uniqueKey":"result.results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"result.results","typeLabel":"object[]"}},"type":"object","uniqueKey":"result","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"result":{"message":"ok","received":3,"successfully":2,"results":[{"id":335838,"status":"ok","message":"Failed to process offer"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"991c70f7-43ce-4b35-b7fe-7123fe93e814":{"description":"Validation error","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","example":"Validation error. (and 3 more errors)","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","example":{"offers.0.price_per_step":["The offers.0.price_per_step field must be a number."],"offers.0.data.71":[{"error":"Invalid value for field: Rank","type":"string","allowed_values":["Challenger","Grandmaster","Master","Diamond","Silver","Bronze","Emerald","Platinum","Iron","Gold"]}],"offers.0.data.74":[{"error":"Invalid value for field: Leveling","type":"string","allowed_values":["Handmade","Automated"]}]},"uniqueKey":"errors","typeLabel":"object"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Validation error. (and 3 more errors)","errors":{"offers.0.price_per_step":["The offers.0.price_per_step field must be a number."],"offers.0.data.71":[{"error":"Invalid value for field: Rank","type":"string","allowed_values":["Challenger","Grandmaster","Master","Diamond","Silver","Bronze","Emerald","Platinum","Iron","Gold"]}],"offers.0.data.74":[{"error":"Invalid value for field: Leveling","type":"string","allowed_values":["Handmade","Automated"]}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"363f5e66-e59d-4ea1-9240-cb28d6ff0ae2":{"description":"Unauthorized","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","example":"Unauthorized","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"e10ab1a1-c455-40fe-b0bb-11c32db56355":{"description":"Forbidden","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","example":"Forbidden","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Forbidden"}}},"exampleType":"generated"}},"exampleType":"generated"},"3676611d-6b8d-4701-922c-4bc82b889ee8":{"description":"Rate limit exceeded. Maximum 100 offers per request and 200 offers per minute per user.","content":{"application/json":{"schema":{"properties":{"message":{"type":"string","example":"Rate limit exceeded: max 200 offers per minute.","uniqueKey":"message","typeLabel":"string"},"budget_used":{"description":"Number of offers already processed in the current minute window","type":"integer","example":180,"uniqueKey":"budget_used","typeLabel":"integer"},"budget_limit":{"description":"Maximum offers allowed per minute","type":"integer","example":200,"uniqueKey":"budget_limit","typeLabel":"integer"},"offers_requested":{"description":"Number of offers in the rejected request","type":"integer","example":50,"uniqueKey":"offers_requested","typeLabel":"integer"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Rate limit exceeded: max 200 offers per minute.","budget_used":180,"budget_limit":200,"offers_requested":50}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"162ad38a-2b4a-4e94-a971-126fd8afe228":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"82f0032c-9dd3-4724-9666-4279cce735b8":{"url":"https://skycoach.gg/","description":"API Server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-docs.json"},"subdomain":"skycoachltd","siteName":"SkyCoach API Documentation","title":"Manage offer (create or edit with automatic status determination) - SkyCoach API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T16:07:06.105Z","originalFileLocation":"api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically. Automatic status determination: - Gold marketplace: Always set to Active if validation passes - Account marketplace: - If data field validation fails → Need Details - If MULTIPLE credential system and no active credentials → Not Active - If all validations pass → On Review (for moderation) Operation type (add/edit): - Operation type is determined automatically by presence of \u0026#x27;id\u0026#x27; field in offer object - If \u0026#x27;id\u0026#x27; is present → edit operation (only provided fields will be updated) - If \u0026#x27;id\u0026#x27; is missing → add operation (all required fields must be provided) Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SkyCoach API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://skycoach.gg/images/favicon/rebranded/1__192x192.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://skycoach.gg/images/favicon/rebranded/1__192x192.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://skycoach.gg/images/favicon/rebranded/1__192x192.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://skycoach.gg/images/favicon/rebranded/1__192x192.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Manage offer (create or edit with automatic status determination) - SkyCoach API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically. Automatic status determination: - Gold marketplace: Always set to Active if validation passes - Account marketplace: - If data field validation fails → Need Details - If MULTIPLE credential system and no active credentials → Not Active - If all validations pass → On Review (for moderation) Operation type (add/edit): - Operation type is determined automatically by presence of \u0026#x27;id\u0026#x27; field in offer object - If \u0026#x27;id\u0026#x27; is present → edit operation (only provided fields will be updated) - If \u0026#x27;id\u0026#x27; is missing → add operation (all required fields must be provided) Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SkyCoach API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://skycoachltd.mintlify.app/_mintlify/api/og/v2?division=Offers\u0026amp;title=Manage+offer+%28create+or+edit+with+automatic+status+determination%29\u0026amp;description=Create+or+edit+offers+with+full+field+validation+including+custom+data+fields.+Status+is+automatically+determined+based+on+validation+results+and+account+capabi\u0026amp;theme=b12d760f4054882b44634e74\u0026amp;signature=f045d71bc22390c864a39e74018eb37d4e849344dd9378119893c481ef3bbd0d\">\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=\"Manage offer (create or edit with automatic status determination) - SkyCoach API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically. Automatic status determination: - Gold marketplace: Always set to Active if validation passes - Account marketplace: - If data field validation fails → Need Details - If MULTIPLE credential system and no active credentials → Not Active - If all validations pass → On Review (for moderation) Operation type (add/edit): - Operation type is determined automatically by presence of \u0026#x27;id\u0026#x27; field in offer object - If \u0026#x27;id\u0026#x27; is present → edit operation (only provided fields will be updated) - If \u0026#x27;id\u0026#x27; is missing → add operation (all required fields must be provided) Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://skycoachltd.mintlify.app/_mintlify/api/og/v2?division=Offers\u0026amp;title=Manage+offer+%28create+or+edit+with+automatic+status+determination%29\u0026amp;description=Create+or+edit+offers+with+full+field+validation+including+custom+data+fields.+Status+is+automatically+determined+based+on+validation+results+and+account+capabi\u0026amp;theme=b12d760f4054882b44634e74\u0026amp;signature=f045d71bc22390c864a39e74018eb37d4e849344dd9378119893c481ef3bbd0d\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/skycoachltd/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SkyCoach API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5A30FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://api.skycoach.gg/#organization\",\"name\":\"SkyCoach API Documentation\",\"url\":\"https://api.skycoach.gg\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://skycoach.gg/images/logos/rebranded/logo.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://api.skycoach.gg/docs#website\",\"name\":\"SkyCoach API Documentation\",\"url\":\"https://api.skycoach.gg/docs\",\"publisher\":{\"@id\":\"https://api.skycoach.gg/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination#webpage\",\"url\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination\",\"name\":\"Manage offer (create or edit with automatic status determination)\",\"description\":\"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically. Automatic status determination: - Gold marketplace: Always set to Active if validation passes - Account marketplace: - If data field validation fails → Need Details - If MULTIPLE credential system and no active credentials → Not Active - If all validations pass → On Review (for moderation) Operation type (add/edit): - Operation type is determined automatically by presence of 'id' field in offer object - If 'id' is present → edit operation (only provided fields will be updated) - If 'id' is missing → add operation (all required fields must be provided) Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.\",\"dateModified\":\"2026-10-14T16:07:06.105Z\",\"isPartOf\":{\"@id\":\"https://api.skycoach.gg/docs#website\"},\"breadcrumb\":{\"@id\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Offers\",\"item\":\"https://api.skycoach.gg/docs/api-reference/offers/show-my-offers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Manage offer (create or edit with automatic status determination)\",\"item\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination#apireference\",\"headline\":\"Manage offer (create or edit with automatic status determination)\",\"name\":\"Manage offer (create or edit with automatic status determination)\",\"description\":\"Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically. Automatic status determination: - Gold marketplace: Always set to Active if validation passes - Account marketplace: - If data field validation fails → Need Details - If MULTIPLE credential system and no active credentials → Not Active - If all validations pass → On Review (for moderation) Operation type (add/edit): - Operation type is determined automatically by presence of 'id' field in offer object - If 'id' is present → edit operation (only provided fields will be updated) - If 'id' is missing → add operation (all required fields must be provided) Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.\",\"url\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination\",\"mainEntityOfPage\":{\"@id\":\"https://api.skycoach.gg/docs/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination#webpage\"},\"dateModified\":\"2026-10-14T16:07:06.105Z\",\"publisher\":{\"@id\":\"https://api.skycoach.gg/#organization\"},\"isPartOf\":{\"@id\":\"https://api.skycoach.gg/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SkyCoach API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SkyCoach API Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Currency Marketplace","pages":[{"title":"Get product list","deprecated":null,"version":null,"openapi":"/api-docs.json get /api/shop/marketplace/products/list","href":"/api-reference/currency-marketplace/get-product-list"},{"title":"Get product by ID","deprecated":null,"version":null,"openapi":"/api-docs.json get /api/shop/marketplace/products/{productId}","href":"/api-reference/currency-marketplace/get-product-by-id"}]},{"group":"Offers","pages":[{"title":"Show my offers","deprecated":null,"version":null,"openapi":"/api-docs.json get /api/shop/marketplace/offers/my_offers","href":"/api-reference/offers/show-my-offers"},{"title":"Delete offer","description":null,"deprecated":null,"version":null,"openapi":"/api-docs.json delete /api/shop/marketplace/offers/{OfferId}/delete","href":"/api-reference/offers/delete-offer"},{"title":"Manage offer (create or edit with automatic status determination)","deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/products/{productId}/offers/manage","href":"/api-reference/offers/manage-offer-create-or-edit-with-automatic-status-determination"},{"title":"Edit offer status","description":null,"deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/offers/{OfferId}/edit_status","href":"/api-reference/offers/edit-offer-status"},{"title":"Attach screenshot","deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/offers/{offerId}/attach_screenshot","href":"/api-reference/offers/attach-screenshot"},{"title":"Detach screenshot","deprecated":null,"version":null,"openapi":"/api-docs.json delete /api/shop/marketplace/offers/{offerId}/detach_screenshot","href":"/api-reference/offers/detach-screenshot"},{"title":"Bulk attach screenshots to offer","deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/offers/{offerId}/attach_screenshots","href":"/api-reference/offers/bulk-attach-screenshots-to-offer"},{"title":"Attach screenshots to offer from external URLs","deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/offers/{offerId}/attach_screenshots_from_links","href":"/api-reference/offers/attach-screenshots-to-offer-from-external-urls"},{"title":"Get verification activity for the last 10 minutes","deprecated":null,"version":null,"openapi":"/api-docs.json get /api/shop/marketplace/offers/sold","href":"/api-reference/offers/get-verification-activity-for-the-last-10-minutes"},{"title":"Get verification history","deprecated":null,"version":null,"openapi":"/api-docs.json get /api/shop/marketplace/offers/sold/history","href":"/api-reference/offers/get-verification-history"}]},{"group":"Offer Credentials","pages":[{"title":"Get list of credentials for offer","deprecated":null,"version":null,"openapi":"/api-docs.json get /api/shop/marketplace/offers/{offerId}/credentials","href":"/api-reference/offer-credentials/get-list-of-credentials-for-offer"},{"title":"Create new credential","deprecated":null,"version":null,"openapi":"/api-docs.json post /api/shop/marketplace/offers/{offerId}/credentials","href":"/api-reference/offer-credentials/create-new-credential"},{"title":"Show credential","deprecated":null,"version":null,"openapi":"/api-docs.json get /api/shop/marketplace/offers/{offerId}/credentials/{credentialId}","href":"/api-reference/offer-credentials/show-credential"},{"title":"Update credential","deprecated":null,"version":null,"openapi":"/api-docs.json put /api/shop/marketplace/offers/{offerId}/credentials/{credentialId}","href":"/api-reference/offer-credentials/update-credential"},{"title":"Delete credential","deprecated":null,"version":null,"openapi":"/api-docs.json delete /api/shop/marketplace/offers/{offerId}/credentials/{credentialId}","href":"/api-reference/offer-credentials/delete-credential"},{"title":"Add credentials to existing ones (batch add)","deprecated":null,"version":null,"openapi":"/api-docs.json post /external_api/pro/offers/{offerId}/credentials/add_batch","href":"/api-reference/offer-credentials/add-credentials-to-existing-ones-batch-add"},{"title":"Replace all credentials (batch replace)","deprecated":null,"version":null,"openapi":"/api-docs.json put /api/shop/marketplace/offers/{offerId}/credentials/replace_all","href":"/api-reference/offer-credentials/replace-all-credentials-batch-replace"}]},{"group":"Offer Discount","pages":[{"title":"Set or remove discount on offer","deprecated":null,"version":null,"openapi":"/api-docs.json put /api/shop/marketplace/offers/{offer}/discount","href":"/api-reference/offer-discount/set-or-remove-discount-on-offer"},{"title":"Set or remove discounts on multiple offers","deprecated":null,"version":null,"openapi":"/api-docs.json put /api/shop/marketplace/offers/discount/bulk","href":"/api-reference/offer-discount/set-or-remove-discounts-on-multiple-offers"}]}]}]},"basePath":"","title":"Manage offer (create or edit with automatic status determination) - SkyCoach API Documentation","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","Page-DeQN5MDd.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}