Edit a job

PATCH

/v1/jobs/{id}

curl --request PATCH \
  --url https://api.gampeon.com/v1/jobs/1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "title": "example", "role": "scripter", "description": "example", "commitment": "one_off", "compensation": "volunteer", "compensationNote": "example", "skills": [ "example" ], "languages": [ "example" ], "links": [ "example" ] }'

• Production

Only for the person who posted it, studio owners and admins, and people who can edit the project. A volunteer job cannot change its compensation while people under 18 have open applications.

Not available with access tokens.

Rate limit: 120 per hour per account.

Authorizations

• session

Parameters

Path Parameters

id

required

integer

>= 1

Job ID

Request Body^required

Media typeapplication/json

object

title

string

>= 4 characters <= 80 characters

role

string

Allowed values: scripter ui_developer mapper modeler animator texture_artist vehicle_artist sound_designer game_designer writer moderator community_manager server_admin tester translator video_creator other

description

string

>= 40 characters <= 4000 characters

commitment

string

Allowed values: one_off part_time ongoing

compensation

string

Allowed values: volunteer revenue_share paid negotiable

compensationNote

string

<= 200 characters

skills

Up to 8 skills, lowercase (a-z, 0-9, -)

Array<string>

<= 8 items

languages

Up to 5 ISO 639-1 language codes, for example en

Array<string>

<= 5 items

links

Up to 3 https:// links

Array<string>

<= 3 items

Responses

200

Updated

Media typeapplication/json

object

id

required

integer

title

required

string

role

required

string

Allowed values: scripter ui_developer mapper modeler animator texture_artist vehicle_artist sound_designer game_designer writer moderator community_manager server_admin tester translator video_creator other

description

required

string

skills

required

Array<string>

commitment

required

string

Allowed values: one_off part_time ongoing

languages

required

Array<string>

links

required

Array<string>

compensation

required

What is offered. Only a statement: no money or GAMPEONS move through GAMPEON. paid is arranged in euros between the parties

string

Allowed values: volunteer revenue_share paid negotiable

compensationNote

required

Free text, for example the amount or the share

string

minAge

required

Minimum age to apply: 16 for volunteer, 18 for everything else

integer

status

required

expired: open, but past expiresAt. removed: removed by moderation, only visible to the team and moderators

string

Allowed values: open closed expired removed

postedBy

required

object

handle

required

string

/^[a-z0-9_]{3,24}$/

displayName

required

string

avatar

required

One of:

string

Image path under /v1/media/

string

null

null

studio

required

One of:

object

object

slug

required

string

name

required

string

logo

required

One of:

string

string

null

null

null

null

project

required

One of:

object

object

slug

required

string

title

required

string

cover

required

One of:

string

string

null

null

null

null

createdAt

required

Unix time in milliseconds

integer format: int64

updatedAt

required

Unix time in milliseconds

integer format: int64

expiresAt

required

Jobs close 30 days after posting or renewing

integer format: int64

removed

object

at

required

Unix time in milliseconds

integer format: int64

reason

required

string

Example

{
  "role": "scripter",
  "commitment": "one_off",
  "compensation": "volunteer",
  "status": "open"
}

400

Error codes: invalid_field

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: token_not_allowed, forbidden

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

404

Error codes: not_found

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

409

Error codes: removed, minor_applicants

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

429

Limit: 120 per hour per account. Error codes: rate_limited

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}