API
⌘K
My Developer Account

Speakership

Example Request

curl https://api.planningcenteronline.com/publishing/v2/episodes/{episode_id}/speakerships

View in API Explorer →

Example Object

{
  "type": "Speakership",
  "id": "1",
  "attributes": {},
  "relationships": {
    "speaker": {
      "data": {
        "type": "Speaker",
        "id": "1"
      }
    }
  }
}

Attributes

Name Type Description
id primary_key

Relationships

Name Type Association Type Note
speaker Speaker to_one Assign via relationship data; speaker_id cannot be set as a direct attribute

Can Include

Parameter Value Description Assignable
include speaker include associated speaker create and update

Pagination

Name Parameter Type Description
per_page per_page integer how many records to return per page (min=1, max=100, default=25)
offset offset integer get results from given offset

Endpoints

Listing

HTTP Method Endpoint
GET /publishing/v2/episodes/{episode_id}/speakerships

Reading

HTTP Method Endpoint
GET /publishing/v2/episodes/{episode_id}/speakerships/{id}

Creating

HTTP Method Endpoint Assignable Attributes
POST /publishing/v2/episodes/{episode_id}/speakerships
  • speaker_id

Updating

HTTP Method Endpoint
PATCH /publishing/v2/episodes/{episode_id}/speakerships/{id}

Deleting

HTTP Method Endpoint
DELETE /publishing/v2/episodes/{episode_id}/speakerships/{id}

Associations

HTTP Method Endpoint Returns Details Filter By
GET https://api.planningcenteronline.com/publishing/v2/episodes/{episode_id}/speakerships/{speakership_id}/speaker Speaker

Belongs To

HTTP Method Endpoint Association Details Filter By
GET https://api.planningcenteronline.com/publishing/v2/episodes/{episode_id}/speakerships Episode