missions

Create mission

Creates a new mission for the domain. Supported mission_type values: keywords_target_position, keywords_morningscore, keywords_gsc, links_count, links_count_rating, links_specific, links_rank, onsite_page_tasks, health_score, health_validator, ai_geo_score_low, ai_geo_health_weak, geo_prompt_answer, custom. You can create many missions; Laravel only deduplicates incomplete missions with the same type and parameters.

post/v1/{domainId}/missions

Request

  • Base URL: https://api.morningscore.io
  • URL: https://api.morningscore.io/v1/{domainId}/missions
  • Auth: HTTP bearer

Path parameters

domainIdstring required
Example:v3.dev.724c7b98c8766f051883aa91a7282204

Request body

mission_type'keywords_target_position' | 'keywords_morningscore' | 'keywords_gsc' | 'links_count' | 'links_count_rating' | 'links_specific' | 'links_rank' | 'onsite_page_tasks' | 'health_score' | 'health_validator' | 'ai_geo_score_low' | 'ai_geo_health_weak' | 'geo_prompt_answer' | 'custom' required

Mission type to create. One of: keywords_target_position, keywords_morningscore, keywords_gsc, links_count, links_count_rating, links_specific, links_rank, onsite_page_tasks, health_score, health_validator, ai_geo_score_low, ai_geo_health_weak, geo_prompt_answer, custom.

keywordstring

Required for keywords_target_position. Keyword to rank for.

targetnumber

Required for every creatable type. Meaning varies: rank position, Morningscore, link count, link rank, tasks to fix, etc.

target_currencystring

Required for keywords_morningscore. Currency for the target score (e.g. USD, DKK).

target_domainstring

Required for links_specific. Referring domain to obtain a link from.

ratingnumber

Required for links_count_rating. Minimum link rating threshold.

pagestring

Required for onsite_page_tasks. Landing page path (e.g. /blog/post/).

onsite_page_idstring

Optional for onsite_page_tasks. Onsite crawler page id when known.

validatorstring

Required for health_validator. Validator slug, for example missing_alt_tags.

promptstring

Required for geo_prompt_answer. The prompt the brand should appear in the answer for. A prompt that is not tracked yet is added to the AI prompt tracker and uses one tracked-prompt credit; creation fails when no credits are left.

headlinestring

Required for custom. Mission headline, at most 20 words.

detailsstring

Optional for custom. Mission description, at most 200 words.

sort_indexinteger
initialinteger
currencystring

Example request

{
  "mission_type": "keywords_target_position"
}

Response

200

missionsobject[] required

Domain missions relation after create (raw model attributes).

messagestring nullable
_request_uuidstring

Changes

No recorded changes to this operation across all 1 revision of this API.