Organization Knocks
Gets the list of all knock requests for the specified organization
Unique ID of the organization
123e4567-e89b-12d3-a456-426614174000
Page number for pagination
1
Example: 1
Number of items per page
20
Example: 20
Filter by knock status
pending
Possible values: Filter by knock type
member
Possible values: List of knocks retrieved successfully
Internal server error
GET /memberships/orgs/{organisationId}/knocks HTTP/1.1
Host: api.example.com
Accept: */*
{
"data": [
{
"id": "knock123-def6-7890-abcd-ef1234567890",
"type": "member",
"status": "pending",
"organisationId": "123e4567-e89b-12d3-a456-426614174000",
"requesterEmail": "jane.doe@example.com",
"requesterInfo": {
"firstName": "Jane",
"lastName": "Doe",
"message": "I would like to join your organization as a frontend developer"
},
"details": {
"member": {
"requestedRole": "member",
"requestedPermissions": [
"read",
"write"
]
}
},
"createdAt": "2024-01-15T10:30:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1,
"hasNext": false,
"hasPrev": false
}
}
Creates a new knock request to join the organization, collective, or team
Unique ID of the organization
123e4567-e89b-12d3-a456-426614174000
Type of knock request
member
Possible values: Email of the person making the knock request
jane.doe@example.com
Knock request created successfully
Internal server error
POST /memberships/orgs/{organisationId}/knocks HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 332
{
"type": "member",
"requesterEmail": "jane.doe@example.com",
"requesterInfo": {
"firstName": "Jane",
"lastName": "Doe",
"message": "I'm a frontend developer with 5 years of experience. I would love to contribute to your organization's engineering team."
},
"details": {
"member": {
"requestedRole": "member",
"requestedPermissions": [
"read",
"write"
]
}
}
}
{
"id": "knock123-def6-7890-abcd-ef1234567890",
"type": "member",
"status": "pending",
"organisationId": "123e4567-e89b-12d3-a456-426614174000",
"requesterEmail": "jane.doe@example.com",
"requesterInfo": {
"firstName": "Jane",
"lastName": "Doe",
"message": "I'm a frontend developer with 5 years of experience. I would love to contribute to your organization's engineering team."
},
"details": {
"member": {
"requestedRole": "member",
"requestedPermissions": [
"read",
"write"
]
}
},
"createdAt": "2024-01-15T10:30:00Z"
}
Gets the information of a specific knock request
Unique ID of the organization
123e4567-e89b-12d3-a456-426614174000
Unique ID of the knock
knock123-def6-7890-abcd-ef1234567890
Knock information retrieved successfully
Internal server error
GET /memberships/orgs/{organisationId}/knocks/{knockId} HTTP/1.1
Host: api.example.com
Accept: */*
{
"id": "knock123-def6-7890-abcd-ef1234567890",
"type": "team",
"status": "pending",
"organisationId": "123e4567-e89b-12d3-a456-426614174000",
"requesterEmail": "alex.tech@example.com",
"requesterInfo": {
"firstName": "Alex",
"lastName": "Martinez",
"message": "I'm a senior engineer with team leadership experience."
},
"details": {
"team": {
"teamId": "team123-def6-7890-abcd-ef1234567890",
"requestedRole": "lead",
"requestedPermissions": [
"read",
"write",
"admin"
]
}
},
"createdAt": "2024-01-15T10:30:00Z"
}
Updates the information of a specific knock request (only pending knocks)
Unique ID of the organization
123e4567-e89b-12d3-a456-426614174000
Unique ID of the knock
knock123-def6-7890-abcd-ef1234567890
Knock updated successfully
Internal server error
PUT /memberships/orgs/{organisationId}/knocks/{knockId} HTTP/1.1
Host: api.example.com
Content-Type: application/json
Accept: */*
Content-Length: 189
{
"requesterInfo": {
"message": "Updated: I'm a senior engineer with 8 years of experience and team leadership background. I'm particularly interested in contributing to your AI initiatives."
}
}
{
"id": "knock123-def6-7890-abcd-ef1234567890",
"type": "team",
"status": "pending",
"organisationId": "123e4567-e89b-12d3-a456-426614174000",
"requesterEmail": "alex.tech@example.com",
"requesterInfo": {
"firstName": "Alex",
"lastName": "Martinez",
"message": "Updated: I'm a senior engineer with 8 years of experience and team leadership background."
},
"details": {
"team": {
"teamId": "team123-def6-7890-abcd-ef1234567890",
"requestedRole": "lead",
"requestedPermissions": [
"read",
"write",
"admin"
]
}
},
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-16T14:20:00Z"
}
Cancels a specific knock request (only pending knocks)
Unique ID of the organization
123e4567-e89b-12d3-a456-426614174000
Unique ID of the knock to cancel
knock123-def6-7890-abcd-ef1234567890
Knock cancelled successfully
Internal server error
DELETE /memberships/orgs/{organisationId}/knocks/{knockId} HTTP/1.1
Host: api.example.com
Accept: */*
{
"success": true,
"message": "Knock request successfully cancelled"
}