Updated API docs with new keys on /createRoom and new API /rooms/$roomid/ban

paul/schema_breaking_changes
Kegan Dougal 2014-09-02 11:53:53 +01:00
parent 5c778f2f15
commit 5539251d82
1 changed files with 54 additions and 0 deletions

View File

@ -296,6 +296,37 @@
} }
] ]
}, },
{
"path": "/rooms/{roomId}/ban",
"operations": [
{
"method": "POST",
"summary": "Ban a user in the room.",
"notes": "This operation can also be done as a PUT by suffixing /{txnId}. The caller must have the required power level to do this operation.",
"type": "void",
"nickname": "ban",
"consumes": [
"application/json"
],
"parameters": [
{
"name": "roomId",
"description": "The room which has the user to ban.",
"required": true,
"type": "string",
"paramType": "path"
},
{
"name": "body",
"description": "The user to ban.",
"required": true,
"type": "BanRequest",
"paramType": "body"
}
]
}
]
},
{ {
"path": "/rooms/{roomId}/state/m.room.member/{userId}", "path": "/rooms/{roomId}/state/m.room.member/{userId}",
"operations": [ "operations": [
@ -657,6 +688,16 @@
"type": "string", "type": "string",
"description": "The alias to give the new room.", "description": "The alias to give the new room.",
"required": false "required": false
},
"name": {
"type": "string",
"description": "Sets the name of the room. Send a m.room.name event after creating the room with the 'name' key specified.",
"required": false
},
"topic": {
"type": "string",
"description": "Sets the topic for the room. Send a m.room.topic event after creating the room with the 'topic' key specified.",
"required": false
} }
} }
}, },
@ -789,6 +830,19 @@
} }
} }
}, },
"BanRequest": {
"id": "BanRequest",
"properties": {
"user_id": {
"type": "string",
"description": "The fully-qualified user ID."
},
"reason": {
"type": "string",
"description": "The reason for the ban."
}
}
},
"InitialSyncRoomData": { "InitialSyncRoomData": {
"id": "InitialSyncRoomData", "id": "InitialSyncRoomData",
"properties": { "properties": {