Audience: a MEMBER OF THE AUTHENTICATED TEAM (the team the token authorizes — with OAuth this can be a customer's team, not your own). Validate pending payouts for that team and return a Talentir URL where a team member reviews and approves them. The screen requires the visitor to sign in and be a member of that team; the sign-in code is pre-sent to the session creator's email.
/session/approvalAudience: a MEMBER OF THE AUTHENTICATED TEAM (the team the token authorizes — with OAuth this can be a customer's team, not your own). Validate pending payouts for that team and return a Talentir URL where a team member reviews and approves them. The screen requires the visitor to sign in and be a member of that team; the sign-in code is pre-sent to the session creator's email.
Team API key generated from team settings. Sent as Authorization: Bearer <api_key>.
In: header
application/json
TypeScript Definitions
Use the request body type in TypeScript.
application/json
curl -X POST "https://example.com/session/approval" \ -H "Content-Type: application/json" \ -d '{ "redirectUrl": "http://example.com", "payoutIds": [ "395907ee-843a-4d27-91d3-86991502a523" ] }'{ "url": "http://example.com"}Payout POST
Audience: the payout RECIPIENT — the creator/rightsholder being paid, who is not a member of the authenticated team. Validate a payout for the authenticated team and return a Talentir URL to send to that recipient: they sign in or sign up with their own email (inferred from the payout) and claim the payout. No team membership is required.
Kyb POST
Audience: a MEMBER OF THE AUTHENTICATED TEAM (the team the token authorizes — with OAuth this can be a customer's team, not your own). Validate the authenticated team and return a Talentir URL where a team member completes KYB (Know Your Business) verification. The screen requires the visitor to sign in and be a member of that team; the sign-in code is pre-sent to the session creator's email.
URL the user is returned to after completing or leaving the Talentir screen.
uriWhose branding the hosted session screen carries. talentir (default): Talentir branding on the main host. team: the authenticated team's white-label subdomain and logo — requires that team's white-label feature. platform: the subdomain and logo of the team operating the calling OAuth client — OAuth-authenticated calls only, requires the operating team's white-label feature. Sandbox and preview hosts keep their current origin and carry the verified brand in a signed token.
"talentir"Value in
IDs of the pending payouts to review for approval.
1 <= itemsOverrides who the one-time sign-in code is pre-sent to (default: the session creator's email). A hint only — the screen still requires the signed-in user to be a member of the team, and any member can switch to their own email.
email