Preview swap acceptance

POST

/v1/rotations/{rotationId}/swap-requests/{requestId}/accept/preview

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
    Method = HttpMethod.Post,
    RequestUri = new Uri("https://api.roundrobinbot.eu/v1/rotations/example/swap-requests/example/accept/preview"),
    Headers =
    {
        { "Authorization", "Bearer <token>" },
    },
    Content = new StringContent("{ \"acknowledgedConflictIds\": [ \"example\" ], \"acknowledgedStartedLegKeys\": [ \"example\" ], \"expectedRevision\": 1, \"operationId\": \"example\" }")
    {
        Headers =
        {
            ContentType = new MediaTypeHeaderValue("application/*+json")
        }
    }
};
using (var response = await client.SendAsync(request))
{
    response.EnsureSuccessStatusCode();
    var body = await response.Content.ReadAsStringAsync();
    Console.WriteLine(body);
}

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://api.roundrobinbot.eu/v1/rotations/example/swap-requests/example/accept/preview"

  payload := strings.NewReader("{ \"acknowledgedConflictIds\": [ \"example\" ], \"acknowledgedStartedLegKeys\": [ \"example\" ], \"expectedRevision\": 1, \"operationId\": \"example\" }")

  req, _ := http.NewRequest("POST", url, payload)

  req.Header.Add("Authorization", "Bearer <token>")
  req.Header.Add("Content-Type", "application/*+json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/*+json");
RequestBody body = RequestBody.create(mediaType, "{ \"acknowledgedConflictIds\": [ \"example\" ], \"acknowledgedStartedLegKeys\": [ \"example\" ], \"expectedRevision\": 1, \"operationId\": \"example\" }");
Request request = new Request.Builder()
  .url("https://api.roundrobinbot.eu/v1/rotations/example/swap-requests/example/accept/preview")
  .post(body)
  .addHeader("Authorization", "Bearer <token>")
  .addHeader("Content-Type", "application/*+json")
  .build();

Response response = client.newCall(request).execute();

import axios from 'axios';

const options = {
  method: 'POST',
  url: 'https://api.roundrobinbot.eu/v1/rotations/example/swap-requests/example/accept/preview',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/*+json'},
  data: '{ "acknowledgedConflictIds": [ "example" ], "acknowledgedStartedLegKeys": [ "example" ], "expectedRevision": 1, "operationId": "example" }'
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

const url = 'https://api.roundrobinbot.eu/v1/rotations/example/swap-requests/example/accept/preview';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/*+json'},
  body: '{ "acknowledgedConflictIds": [ "example" ], "acknowledgedStartedLegKeys": [ "example" ], "expectedRevision": 1, "operationId": "example" }'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.roundrobinbot.eu/v1/rotations/example/swap-requests/example/accept/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/*+json' \
  --data '{ "acknowledgedConflictIds": [ "example" ], "acknowledgedStartedLegKeys": [ "example" ], "expectedRevision": 1, "operationId": "example" }'

Requires a Slack member access token and the current request revision in expectedRevision. Returns conflicts and the rotation ETag without accepting the request. Review the conflicts before acknowledging them in the acceptance request.

Authorizations

Participant

Parameters

Path Parameters

rotationId

required

string

requestId

required

string

Request Body^required

The reviewed request revision, conflict acknowledgments and remaining-time consent for a swap response.

object

acknowledgedConflictIds

Current conflict identifiers acknowledged for the interval this caller would receive.

Array<string>

acknowledgedStartedLegKeys

Keys of started intervals whose remaining time the recipient agrees to exchange. Include every preview leg with hasStarted set to true when accepting.

Array<string>

expectedRevision

The request revision reviewed by the caller.

integer format: int64

operationId

A caller-generated identifier of at most 128 characters. Reuse it only for an identical retry.

string

Example^generated

{
  "acknowledgedConflictIds": [
    "example"
  ],
  "acknowledgedStartedLegKeys": [
    "example"
  ],
  "expectedRevision": 1,
  "operationId": "example"
}

The reviewed request revision, conflict acknowledgments and remaining-time consent for a swap response.

object

acknowledgedConflictIds

Current conflict identifiers acknowledged for the interval this caller would receive.

Array<string>

acknowledgedStartedLegKeys

Keys of started intervals whose remaining time the recipient agrees to exchange. Include every preview leg with hasStarted set to true when accepting.

Array<string>

expectedRevision

The request revision reviewed by the caller.

integer format: int64

operationId

A caller-generated identifier of at most 128 characters. Reuse it only for an identical retry.

string

Example^generated

{
  "acknowledgedConflictIds": [
    "example"
  ],
  "acknowledgedStartedLegKeys": [
    "example"
  ],
  "expectedRevision": 1,
  "operationId": "example"
}

The reviewed request revision, conflict acknowledgments and remaining-time consent for a swap response.

object

acknowledgedConflictIds

Current conflict identifiers acknowledged for the interval this caller would receive.

Array<string>

acknowledgedStartedLegKeys

Keys of started intervals whose remaining time the recipient agrees to exchange. Include every preview leg with hasStarted set to true when accepting.

Array<string>

expectedRevision

The request revision reviewed by the caller.

integer format: int64

operationId

A caller-generated identifier of at most 128 characters. Reuse it only for an identical retry.

string

Example^generated

{
  "acknowledgedConflictIds": [
    "example"
  ],
  "acknowledgedStartedLegKeys": [
    "example"
  ],
  "expectedRevision": 1,
  "operationId": "example"
}

The reviewed request revision, conflict acknowledgments and remaining-time consent for a swap response.

object

acknowledgedConflictIds

Current conflict identifiers acknowledged for the interval this caller would receive.

Array<string>

acknowledgedStartedLegKeys

Keys of started intervals whose remaining time the recipient agrees to exchange. Include every preview leg with hasStarted set to true when accepting.

Array<string>

expectedRevision

The request revision reviewed by the caller.

integer format: int64

operationId

A caller-generated identifier of at most 128 characters. Reuse it only for an identical retry.

string

Example^generated

{
  "acknowledgedConflictIds": [
    "example"
  ],
  "acknowledgedStartedLegKeys": [
    "example"
  ],
  "expectedRevision": 1,
  "operationId": "example"
}

Responses

200

application/json

The proposed assignments and whether conflict acknowledgments and remaining-time consent permit proceeding.

object

canProceed

required

Whether conflict acknowledgments and remaining-time consent permit proceeding.

boolean

legs

required

The proposed assignments.

Array<object>

One proposed assignment and its conflicts. canAcknowledge identifies conflicts this caller may acknowledge. When hasStarted is true, from and to describe the remaining time; accepting requires its key in acknowledgedStartedLegKeys.

object

acknowledged

boolean

assigneeUserId

required

string

canAcknowledge

required

boolean

conflicts

required

Array<object>

A conflict or an uncertainty affecting the proposed assignment.

object

canAcknowledge

required

Whether explicit acknowledgment permits proceeding with this conflict. False means the conflict blocks the write.

boolean

from

required

The inclusive UTC start of the conflict intersection with the requested interval.

string format: date-time

required

The acknowledgment identifier for this conflict and the previewed terms.

string

source

required

arrangement, manualAvailability, googleCalendar or slackStatus.

string

required

The exclusive UTC end of the conflict intersection with the requested interval.

string format: date-time

type

required

absence, sameCellArrangement or unknownAvailability.

string

userId

required

The affected person’s Slack user identifier.

string

from

required

string format: date-time

hasStarted

boolean

key

required

string

required

string format: date-time

oneClick

Set on an acceptance preview and null on a proposal preview.

null | string

Example

{
  "legs": [
    {
      "acknowledged": false,
      "hasStarted": false
    }
  ]
}

Preview swap acceptance

Authorizations

Parameters

Path Parameters

Request Bodyrequired

Examplegenerated

Examplegenerated

Examplegenerated

Examplegenerated

Responses

200

Example

Request Body^required

Example^generated

Example^generated

Example^generated

Example^generated