Apply athletes to job

curl --request POST \
  --url http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_id": 1038,
  "athlete_ids": [
    132,
    1181
  ],
  "sign_agreement_upfront": true,
  "agreement_signed_name": "Univ mm",
  "athlete_{id}": [],
  "will_disclose": "Y",
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}
'

import requests

url = "http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job"

payload = {
    "job_id": 1038,
    "athlete_ids": [132, 1181],
    "sign_agreement_upfront": True,
    "agreement_signed_name": "Univ mm",
    "athlete_{id}": [],
    "will_disclose": "Y",
    "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_id: 1038,
    athlete_ids: [132, 1181],
    sign_agreement_upfront: true,
    agreement_signed_name: 'Univ mm',
    'athlete_{id}': [],
    will_disclose: 'Y',
    image: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...'
  })
};

fetch('http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_id' => 1038,
    'athlete_ids' => [
        132,
        1181
    ],
    'sign_agreement_upfront' => true,
    'agreement_signed_name' => 'Univ mm',
    'athlete_{id}' => [
        
    ],
    'will_disclose' => 'Y',
    'image' => 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job"

	payload := strings.NewReader("{\n  \"job_id\": 1038,\n  \"athlete_ids\": [\n    132,\n    1181\n  ],\n  \"sign_agreement_upfront\": true,\n  \"agreement_signed_name\": \"Univ mm\",\n  \"athlete_{id}\": [],\n  \"will_disclose\": \"Y\",\n  \"image\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_id\": 1038,\n  \"athlete_ids\": [\n    132,\n    1181\n  ],\n  \"sign_agreement_upfront\": true,\n  \"agreement_signed_name\": \"Univ mm\",\n  \"athlete_{id}\": [],\n  \"will_disclose\": \"Y\",\n  \"image\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_id\": 1038,\n  \"athlete_ids\": [\n    132,\n    1181\n  ],\n  \"sign_agreement_upfront\": true,\n  \"agreement_signed_name\": \"Univ mm\",\n  \"athlete_{id}\": [],\n  \"will_disclose\": \"Y\",\n  \"image\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Athletes successfully Applied",
  "errors": [],
  "applied": [],
  "error_details": [
    {
      "message": "Jane Doe already applied to the Job.",
      "error_code": null,
      "athlete_id": 132
    }
  ]
}

{
  "message": "Please answer the screening questions to apply.",
  "error_code": "SCREENING_ANSWERS_REQUIRED",
  "errors": {
    "job_id": 1038,
    "athlete_ids": [
      132
    ],
    "athletes": [
      {
        "id": 132,
        "name": "Jane Doe",
        "question_ids": [
          41,
          42
        ]
      }
    ],
    "payout_status": null
  }
}

Apply athletes to job

Apply one or more athletes to a job. Requires agreement acceptance. Screening answers are sent as dynamic keys ‘athlete_’ (e.g. athlete_132, athlete_1181) — each is an array of objects with question_id, question, and answer. Prerequisites are enforced server-side in a fixed order and the first failure refuses the whole request with 400 and a stable error_code: AGENT_NOT_APPROVED, ATHLETE_NOT_LINKED, ATHLETE_NOT_APPROVED, AGENT_PHOTO_REQUIRED, ATHLETE_PHOTO_REQUIRED, AGENT_PAYOUT_REQUIRED, then SCREENING_ANSWERS_REQUIRED. Branch on the code, never on the message. AGENT_PAYOUT_REQUIRED is raised only when no Stripe Express account exists at all; an account Stripe is still verifying is accepted, matching the athlete rule, so an agent who finished onboarding is never left stranded. SCREENING_ANSWERS_REQUIRED (ENG-1357) is checked last on purpose: the payout intercept sends the agent to Stripe Express and the answers held in the client are lost on the way back, so checking screening earlier would return an agent to questions they had already completed. Clients should persist the full request payload before starting Express onboarding and resubmit it on return rather than re-running their own screening check. That check applies only when the deal has configured screening questions, and every configured question needs a non-empty answer for every selected athlete; a shipping-address answer_payload counts as an answer.

POST

agent

apply-athletes-to-job

curl --request POST \
  --url http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "job_id": 1038,
  "athlete_ids": [
    132,
    1181
  ],
  "sign_agreement_upfront": true,
  "agreement_signed_name": "Univ mm",
  "athlete_{id}": [],
  "will_disclose": "Y",
  "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}
'

import requests

url = "http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job"

payload = {
    "job_id": 1038,
    "athlete_ids": [132, 1181],
    "sign_agreement_upfront": True,
    "agreement_signed_name": "Univ mm",
    "athlete_{id}": [],
    "will_disclose": "Y",
    "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    job_id: 1038,
    athlete_ids: [132, 1181],
    sign_agreement_upfront: true,
    agreement_signed_name: 'Univ mm',
    'athlete_{id}': [],
    will_disclose: 'Y',
    image: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...'
  })
};

fetch('http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'job_id' => 1038,
    'athlete_ids' => [
        132,
        1181
    ],
    'sign_agreement_upfront' => true,
    'agreement_signed_name' => 'Univ mm',
    'athlete_{id}' => [
        
    ],
    'will_disclose' => 'Y',
    'image' => 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job"

	payload := strings.NewReader("{\n  \"job_id\": 1038,\n  \"athlete_ids\": [\n    132,\n    1181\n  ],\n  \"sign_agreement_upfront\": true,\n  \"agreement_signed_name\": \"Univ mm\",\n  \"athlete_{id}\": [],\n  \"will_disclose\": \"Y\",\n  \"image\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"job_id\": 1038,\n  \"athlete_ids\": [\n    132,\n    1181\n  ],\n  \"sign_agreement_upfront\": true,\n  \"agreement_signed_name\": \"Univ mm\",\n  \"athlete_{id}\": [],\n  \"will_disclose\": \"Y\",\n  \"image\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://localhost/mogl/mogl-backend/api/agent/apply-athletes-to-job")

http = Net::HTTP.new(url.host, url.port)

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"job_id\": 1038,\n  \"athlete_ids\": [\n    132,\n    1181\n  ],\n  \"sign_agreement_upfront\": true,\n  \"agreement_signed_name\": \"Univ mm\",\n  \"athlete_{id}\": [],\n  \"will_disclose\": \"Y\",\n  \"image\": \"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...\"\n}"

response = http.request(request)
puts response.read_body

{
  "message": "Athletes successfully Applied",
  "errors": [],
  "applied": [],
  "error_details": [
    {
      "message": "Jane Doe already applied to the Job.",
      "error_code": null,
      "athlete_id": 132
    }
  ]
}

{
  "message": "Please answer the screening questions to apply.",
  "error_code": "SCREENING_ANSWERS_REQUIRED",
  "errors": {
    "job_id": 1038,
    "athlete_ids": [
      132
    ],
    "athletes": [
      {
        "id": 132,
        "name": "Jane Doe",
        "question_ids": [
          41,
          42
        ]
      }
    ],
    "payout_status": null
  }
}

Authorizations

Authorization

string

header

required

JWT Bearer token authentication. Use the /api/login endpoint to obtain a token.

Body

application/json

job_id

integer

required

Job ID to apply to

Example:

1038

athlete_ids

integer[]

required

Array of athlete user IDs

Example:

[132, 1181]

sign_agreement_upfront

boolean

required

Must be true to proceed

Example:

true

agreement_signed_name

string

required

Name used for agreement signing

Example:

"Univ mm"

athlete_{id}

object[]

Dynamic key per athlete (e.g. athlete_132). Array of screening question answers for that athlete.

Show child attributes

Example:

[]

will_disclose

enum<string> | null

Will disclose (default Y)

Available options:

Y,

N

Example:

"Y"

image

string | null

Optional base64 image attachment

Example:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUg..."

Response

The prerequisites passed and each selected athlete was processed individually. A non-empty errors or error_details here is a partial result, not a failed request: show the athletes in applied as applied and attach each failure to its matching athlete.

message

string

Example:

"Athletes successfully Applied"

errors

string[]

Per-athlete failure messages. Kept for existing clients.

Example:

[]

applied

string[]

Per-athlete success messages.

Example:

[]

error_details

object[]

Additive companion to errors (ENG-1357): the same failures, with the athlete each one belongs to and a code where one applies. Prefer this over parsing errors.

Show child attributes

Core API

University API

Notifications API

Apply athletes to job

Authorizations

Body

Response