Skip to main content

Staff

**Endpoint:** `/wp-json/sportspress/v2/staff`

Updated today

Staff

Endpoint: /wp-json/sportspress/v2/staff

Field Definitions

Date and Time Fields

Field

Description

date

Publication date in site timezone (ISO 8601 format)

date_gmt

Publication date as GMT (ISO 8601 format)

modified

Last modification date in site timezone (read-only)

modified_gmt

Last modification date as GMT (read-only)

Identification Fields

Field

Description

id

Unique identifier for the object (integer, read-only)

guid

Globally unique identifier (read-only)

slug

Alphanumeric identifier unique to its type

link

URL to the object (read-only)

Content Fields

Field

Description

title

The staff member's name

content

The staff member's biography or description

excerpt

A brief summary for the staff member

author

The ID for the author of the object

featured_media

The ID of the featured media (photo) for the object

Status and Access Fields

Field

Description

status

Named status for the object; one of publish, future, draft, pending, or private (edit context only)

password

A password to protect access to the content and excerpt (edit context only)

comment_status

Whether or not comments are open; open or closed

ping_status

Whether or not the object can be pinged; open or closed

Order Fields

Field

Description

menu_order

The order of the object in relation to other objects of its type

Taxonomy Fields

Field

Description

leagues

The terms assigned to the object in the league taxonomy (array of term IDs)

seasons

The terms assigned to the object in the season taxonomy (array of term IDs)

roles

The terms assigned to the object in the role taxonomy (staff jobs, array of term IDs)

Staff-Specific Fields

Field

Description

nationalities

3-letter country codes for the staff member's nationalities (array of strings)

teams

The IDs of all teams the staff member is associated with (array — current and past)

current_teams

The IDs of the staff member's current active team associations (array)

past_teams

The IDs of the staff member's historical team associations (array)

Fields operate within different contexts (view, edit, embed) that control accessibility and visibility depending on the use case. Fields such as guid, id, link, and modification timestamps are read-only.

Example Requests

List All Staff

GET /wp-json/sportspress/v2/staff

Retrieve a Single Staff Member

GET /wp-json/sportspress/v2/staff/77

Create a Staff Member

POST /wp-json/sportspress/v2/staff
Content-Type: application/json{
  "title": "Jane Doe",
  "status": "publish",
  "nationalities": ["gbr"],
  "current_teams": [10],
  "roles": [8],
  "leagues": [5],
  "seasons": [3]
}

Update a Staff Member's Teams

PUT /wp-json/sportspress/v2/staff/77
Content-Type: application/json{
  "current_teams": [10, 12],
  "past_teams": [9]
}

Did this answer your question?