Teamly API
  1. Voice
Teamly API
  • Introduction
  • Getting Started
    • Quick Start
    • API Versions
  • Permissions
    • Channel Permission Values
    • Team Global Permissions
  • Core Resources
    • Channels
      • Update Channel
        • Update Team Channel
        • Update Channel Role Permissions
      • Get Team Channels
      • Create Team Channel
      • Delete Team Channel
      • Duplicate a Channel on Team
      • Update Channel Priorities of Team
    • Messages
      • Create Channel Message
      • Delete a Channel Message
      • Get Channel Messages
      • Update a Channel Message
      • React to Message
      • Delete Reaction from Message
      • Get a Channel Message by Id
    • Teams
      • Members
        • Add Role to Member
        • Remove Role from Member
        • Kick Member from Team
        • Get Member
      • Bans
        • Get Banned Users
        • Unban User
        • Ban User
      • Get a Team
      • Update a Team
    • Roles
      • Create a Role for Team
      • Get Team Roles
      • Delete a Role
      • Clone Role
      • Update Role Priorities of Team
      • Update a Team Role
    • Users
      • Get User By Id
      • Get Logged In User
    • Todos
      • Get Todo Items
      • Create Todo Item
      • Delete Todo Item
      • Clone Todo Item
      • Update Todo Item
    • Direct Messages
      • Create a Direct Message
    • Applications
      • Get Application Submissions
      • Update a Application Status
      • Update Team's Application Status
      • Update Team's Application Questions
      • Get Application By Id
    • Reactions
      • Get Team's Custom Reactions
      • Create New Custom Reaction for Team
      • Update a Custom Reaction
      • Delete a Custom Reaction
    • Attachments
      • Upload Attachment
    • Voice
      • Get Credentials for Join Voice Channel
        GET
      • Update Your Voice Metadata
        POST
      • Leave from Voice Channel
        GET
    • Webhooks
      • Create Message With Webhook
      • Webhook for GitHub
    • Blog
      • Get Blog Posts
      • Create a Blog Post
      • Delete a Blog Post
    • Category
      • Create a Category
      • Update a Category
      • Update Category Role Permissions
      • Delete a Category
      • Add a Channel To Category
      • Delete a channel from category
      • Set channel priority of category
      • Set a team's category priority
  • Schemas
    • Message
    • Message Embed
    • Channel
    • Direct Message
    • To-do Item
    • Application
    • Emoji
    • Team
    • User
    • Role
    • Webhook
    • Blog
    • Category
  • Websockets
    • Example Bot
    • WebSocket event envelope
      • WebSocket event envelope
      • Keepalive
      • Welcome Message
      • Gateway Opcodes
      • Gateway Close Event Codes
    • Websocket events
      • CHANNEL_CREATED
      • CHANNEL_DELETED
      • CHANNEL_UPDATED
      • MESSAGE_SEND
      • MESSAGE_UPDATED
      • MESSAGE_DELETED
      • MESSAGE_REACTION_ADDED
      • MESSAGE_REACTION_REMOVED
      • PRESENCE_UPDATE
      • TEAM_ROLE_CREATED
      • TEAM_ROLE_DELETED
      • TEAM_ROLES_UPDATED
      • TEAM_UPDATED
      • TODO_ITEM_CREATED
      • TODO_ITEM_DELETED
      • TODO_ITEM_UPDATED
      • USER_JOINED_TEAM
      • USER_LEFT_TEAM
      • USER_JOINED_VOICE_CHANNEL
      • USER_LEFT_VOICE_CHANNEL
      • USER_PROFILE_UPDATED
      • USER_ROLE_ADDED
      • USER_ROLE_REMOVED
      • USER_UPDATED_VOICE_METADATA
      • BLOG_CREATED
      • BLOG_DELETED
      • CATEGORIES_PRIORITY_UPDATED
      • CATEGORY_UPDATED
      • CATEGORY_DELETED
      • CATEGORY_CREATED
      • CHANNELS_PRIORITY_UPDATED
    • Connecting via WebSocket
  1. Voice

Get Credentials for Join Voice Channel

GET
https://api.teamly.one/api/v1/teams/{teamId}/channels/{channelId}/join

Request

Path Params
teamId
string 
required
channelId
string 
required
Query Params
isMuted
boolean 
optional
Example:
true
isDeafened
boolean 
optional
Example:
false
Header Params
Authorization
string 
required
Default:
Bot {token}
Content-Type
string 
required
Default:
application/json

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.teamly.one/api/v1/teams//channels//join?isMuted=true&isDeafened=false' \
--header 'Authorization;'

Responses

🟢200Success
application/json
Body
success
boolean 
required
Indicates if the operation was successful.
userId
string 
required
ID of the user initiating or involved in the meeting.
channelId
string 
required
ID of the channel associated with the meeting.
meetingData
object 
required
ExternalMeetingId
string 
required
Unique external ID for the meeting.
MediaPlacement
object 
required
MediaRegion
string 
required
AWS region where the media is hosted.
MeetingArn
string 
required
ARN of the meeting.
MeetingId
string 
required
Unique ID of the meeting.
TenantIds
array[string]
required
List of tenant IDs associated with the meeting.
attendeeData
object 
required
AttendeeId
string 
required
Unique ID for the attendee.
Capabilities
object 
required
ExternalUserId
string 
required
External ID of the attendee user.
JoinToken
string 
required
Token used by the attendee to join the meeting.
Example
{
  "isSuccess": true,
  "userId": "ab12cd34ef56gh78",
  "channelId": "98zy76wx54vu32ts",
  "meetingDetails": {
    "externalMeetingId": "123e4567-e89b-12d3-a456-426614174000",
    "mediaPlacement": {
      "audioFallbackUrl": "wss://example.aws:443/calls/abc12345-def6-7890-gh12-ijkl34567890",
      "audioHostUrl": "audio123.aws:3478",
      "eventIngestionUrl": "https://data.example.com/v1/client-events",
      "screenDataUrl": "wss://example.aws:443/v2/screen/abc12345-def6-7890-gh12-ijkl34567890",
      "screenSharingUrl": "wss://example.aws:443/v2/screen/abc12345-def6-7890-gh12-ijkl34567890",
      "screenViewingUrl": "wss://example.aws:443/ws/connect?passcode=examplePass&viewer_uuid=exampleUUID&X-BitHub-Call-Id=abc12345-def6-7890-gh12-ijkl34567890",
      "signalingUrl": "wss://signal.example.com/control/abc12345-def6-7890-gh12-ijkl34567890",
      "turnControlUrl": "https://turn.example.com/v2/turn_sessions"
    },
    "region": "eu-west-1",
    "meetingArn": "arn:aws:chime:eu-west-1:123456789012:meeting/abc12345-def6-7890-gh12-ijkl34567890",
    "meetingId": "abc12345-def6-7890-gh12-ijkl34567890",
    "tenantIds": []
  },
  "attendeeDetails": {
    "attendeeId": "xyz98765-4321-abcd-efgh-567890123456",
    "capabilities": {
      "audio": "SendReceive",
      "content": "SendReceive",
      "video": "SendReceive"
    },
    "externalUserId": "ab12cd34ef56gh78",
    "joinToken": "eHl6OTg3NjUtNDMyMS1hYmNkLWVmZ2gtNTY3ODkwMTIzNDU2OmFiYzEyMzQ1LTY3ODktYWJjZC1lZmdoLTU2Nzg5MDEyMzQ1Ng"
  }
}
Previous
Upload Attachment
Next
Update Your Voice Metadata
Built with