Skip to content

/v1/me/society-memberships/{role}

PUT
/v1/me/society-memberships/{role}
curl --request PUT \
--url https://api.emely.io/v1/me/society-memberships/songwriter \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '[ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "agencyCode": "example", "memberNumber": "example", "ipn": "example", "isPrimary": true, "rights": [ "example" ], "names": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "name": "example", "ipiCae": "example", "kind": "example", "labelCode": "example" } ], "territories": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "tisCode": 1, "inclusionExclusion": "example", "seq": 1 } ], "rightTerritories": [ { "rightType": "example", "territories": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "tisCode": 1, "inclusionExclusion": "example", "seq": 1 } ] } ] } ]'

Replace the caller’s memberships for one role via the setSocietyMemberships Action. The owner is resolved server-side: songwriter/performer write the caller’s own person, publisher/label the caller’s workspace (pass workspaceId when a member of more than one). Send the full list: ids keep existing rows, absent rows are removed. Absence rule per field: omitted = untouched, null clears where allowed, [] clears a list. Membership identifiers are write-only input; the party IP Base Number is managed on the person or home publisher in the app. An imported or verified membership IPN is locked: a changed or cleared value, or removal of its membership, returns 409, and a correction must be reported in the app for operator review. Requires an api_user token.

role
required
string
Allowed values: songwriter performer publisher label
workspaceId
string format: uuid
Media typeapplication/json
Array<object>
<= 200 items
object
id
string format: uuid
agencyCode
required
string
>= 1 characters <= 200 characters
memberNumber
string | null
<= 200 characters
ipn
string | null
<= 200 characters
isPrimary
boolean
rights
Array<string>
<= 200 items
names
Array<object>
<= 200 items
object
id
string format: uuid
name
required
string
>= 1 characters <= 2000 characters
ipiCae
string | null
<= 200 characters
kind
string | null
<= 200 characters
labelCode
string | null
<= 200 characters
territories
Array<object>
<= 200 items
object
id
string format: uuid
tisCode
required
integer
inclusionExclusion
string
<= 200 characters
seq
integer
rightTerritories
Array<object>
<= 200 items
object
rightType
required
string
>= 1 characters <= 200 characters
territories
required
Array<object>
<= 200 items
object
id
string format: uuid
tisCode
required
integer
inclusionExclusion
string
<= 200 characters
seq
integer
Examplegenerated
[
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"agencyCode": "example",
"memberNumber": "example",
"ipn": "example",
"isPrimary": true,
"rights": [
"example"
],
"names": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"name": "example",
"ipiCae": "example",
"kind": "example",
"labelCode": "example"
}
],
"territories": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"tisCode": 1,
"inclusionExclusion": "example",
"seq": 1
}
],
"rightTerritories": [
{
"rightType": "example",
"territories": [
{
"id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"tisCode": 1,
"inclusionExclusion": "example",
"seq": 1
}
]
}
]
}
]

The role’s memberships after the write

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
role
required
string
Allowed values: songwriter performer publisher label
owner
required
One of:
object
type
required
string
Allowed values: person
society
required
object
code
required
string
name
required
string
kind
required
string
active
required
boolean
isPrimary
required
boolean
hasMemberNumber
required
boolean
hasIpn
required
boolean
rights
required
Array<object>
object
id
required
string
rightType
required
string
source
required
string | null
administeringAgencyCode
required
string | null
territoriesOverridden
required
boolean
territories
required
Array<object>
object
id
required
string
tisCode
required
integer
inclusionExclusion
required
string
seq
required
integer
territories
required
Array<object>
object
id
required
string
tisCode
required
integer
inclusionExclusion
required
string
seq
required
integer
names
required
Array<object>
object
id
required
string
name
required
string
kind
string
labelCode
string | null
hasIpiCae
boolean
Example
{
"items": [
{
"role": "songwriter",
"owner": {
"type": "person"
}
}
]
}

Invalid input, or an ambiguous/misused workspaceId

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Missing or invalid bearer token

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Token role refused for this route, or no write access to the workspace

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

No resolvable owner (no person or no workspace)

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

A locked membership identifier must be reported for review

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}

Upstream error

Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer
detail
string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example"
}