Registration routes: admit, approve, attend
The Registration Verbs admit, approve, attend as api.sb routes, with inputs, result, refusals and an example.
Reference for Registration, one group of Registration routes.
Registration.admit
Admit gives the next Contact in line a place at a Gathering when one frees up or its capacity rises. Verb page.
POST /{namespace}/ registrations/ {registration}/ admitPath: registration. Emits Registration.admitted.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
registration | Registration | required | The waitlisted Registration. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
registration | Registration | required | The Registration, now registered. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
| The Gathering is at capacity | refused | Clear what the check names, then call it again. | None. |
Example
curl -X POST https: //api.sb/ leaseline.app/ registrations/ registration_95lvb7R17L/ admit \
-H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"{
"api": "https: //api.sb/ leaseline.app",
"registration": {
"$id": "https: //api.sb/ leaseline.app/ registrations/ registration_95lvb7R17L",
"$type": "Registration",
"status": "invited"
},
"action": {
"$id": "https: //api.sb/ leaseline.app/ actions/ act_br07HsG8MG",
"operation": "Registration.admit",
"status": "done"
},
"links": {
"self": "https: //api.sb/ leaseline.app/ actions/ act_br07HsG8MG"
}
}Registration.approve
Approve gives a requested place at a Gathering to the Contact who asked, or a place in line when the Gathering is full. Verb page.
POST /{namespace}/ registrations/ {registration}/ approvePath: registration. Emits Registration.approved.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
registration | Registration | required | The requested Registration. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
registration | Registration | required | The Registration, registered or waitlisted. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
curl -X POST https: //api.sb/ leaseline.app/ registrations/ registration_95lvb7R17L/ approve \
-H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"{
"api": "https: //api.sb/ leaseline.app",
"registration": {
"$id": "https: //api.sb/ leaseline.app/ registrations/ registration_95lvb7R17L",
"$type": "Registration",
"status": "invited"
},
"action": {
"$id": "https: //api.sb/ leaseline.app/ actions/ act_br07HsG8MG",
"operation": "Registration.approve",
"status": "done"
},
"links": {
"self": "https: //api.sb/ leaseline.app/ actions/ act_br07HsG8MG"
}
}Registration.attend
Attend records that a registered Contact joined the Gathering; an online room calls it on join. Verb page.
POST /{namespace}/ registrations/ {registration}/ attendPath: registration. Emits Registration.attended.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
registration | Registration | required | The Registration of the Contact who joined. |
Returns
| Output | Type | Required | Description |
|---|---|---|---|
registration | Registration | required | The Registration, now attended. |
Refuses when
| Check | Error | Fix | Then call |
|---|---|---|---|
| The key is valid, but its scopes do not allow this operation. | forbidden | Use a key whose scopes cover the operation, or ask an owner of the namespace to grant them. | None. |
Example
curl -X POST https: //api.sb/ leaseline.app/ registrations/ registration_95lvb7R17L/ attend \
-H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"{
"api": "https: //api.sb/ leaseline.app",
"registration": {
"$id": "https: //api.sb/ leaseline.app/ registrations/ registration_95lvb7R17L",
"$type": "Registration",
"status": "attended"
},
"action": {
"$id": "https: //api.sb/ leaseline.app/ actions/ act_br07HsG8MG",
"operation": "Registration.attend",
"status": "done"
},
"links": {
"self": "https: //api.sb/ leaseline.app/ actions/ act_br07HsG8MG"
}
}