1# Calls

2 

3## Accept call

4 

5`realtime().calls().accept(CallAcceptParamsparams, RequestOptionsrequestOptions = RequestOptions.none())`

6 

7**post** `/realtime/calls/{call_id}/accept`

8 

9Accept call

10 

11### Parameters

12 

13- `CallAcceptParams params`

14 

15 - `Optional<String> callId`

16 

17 - `RealtimeSessionCreateRequest realtimeSessionCreateRequest`

18 

19 Realtime session object configuration.

20 

21### Example

22 

23```java

24package com.openai.example;

25 

26import com.openai.client.OpenAIClient;

27import com.openai.client.okhttp.OpenAIOkHttpClient;

28import com.openai.models.realtime.RealtimeSessionCreateRequest;

29import com.openai.models.realtime.calls.CallAcceptParams;

30 

31public final class Main {

32 private Main() {}

33 

34 public static void main(String[] args) {

35 OpenAIClient client = OpenAIOkHttpClient.fromEnv();

36 

37 CallAcceptParams params = CallAcceptParams.builder()

38 .callId("call_id")

39 .realtimeSessionCreateRequest(RealtimeSessionCreateRequest.builder().build())

40 .build();

41 client.realtime().calls().accept(params);

42 }

43}

44```

45 

46## Hang up call

47 

48`realtime().calls().hangup(CallHangupParamsparams = CallHangupParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`

49 

50**post** `/realtime/calls/{call_id}/hangup`

51 

52Hang up call

53 

54### Parameters

55 

56- `CallHangupParams params`

57 

58 - `Optional<String> callId`

59 

60### Example

61 

62```java

63package com.openai.example;

64 

65import com.openai.client.OpenAIClient;

66import com.openai.client.okhttp.OpenAIOkHttpClient;

67import com.openai.models.realtime.calls.CallHangupParams;

68 

69public final class Main {

70 private Main() {}

71 

72 public static void main(String[] args) {

73 OpenAIClient client = OpenAIOkHttpClient.fromEnv();

74 

75 client.realtime().calls().hangup("call_id");

76 }

77}

78```

79 

80## Refer call

81 

82`realtime().calls().refer(CallReferParamsparams, RequestOptionsrequestOptions = RequestOptions.none())`

83 

84**post** `/realtime/calls/{call_id}/refer`

85 

86Refer call

87 

88### Parameters

89 

90- `CallReferParams params`

91 

92 - `Optional<String> callId`

93 

94 - `String targetUri`

95 

96 URI that should appear in the SIP Refer-To header. Supports values like

97 `tel:+14155550123` or `sip:agent@example.com`.

98 

99### Example

100 

101```java

102package com.openai.example;

103 

104import com.openai.client.OpenAIClient;

105import com.openai.client.okhttp.OpenAIOkHttpClient;

106import com.openai.models.realtime.calls.CallReferParams;

107 

108public final class Main {

109 private Main() {}

110 

111 public static void main(String[] args) {

112 OpenAIClient client = OpenAIOkHttpClient.fromEnv();

113 

114 CallReferParams params = CallReferParams.builder()

115 .callId("call_id")

116 .targetUri("tel:+14155550123")

117 .build();

118 client.realtime().calls().refer(params);

119 }

120}

121```

122 

123## Reject call

124 

125`realtime().calls().reject(CallRejectParamsparams = CallRejectParams.none(), RequestOptionsrequestOptions = RequestOptions.none())`

126 

127**post** `/realtime/calls/{call_id}/reject`

128 

129Reject call

130 

131### Parameters

132 

133- `CallRejectParams params`

134 

135 - `Optional<String> callId`

136 

137 - `Optional<Long> statusCode`

138 

139 SIP response code to send back to the caller. Defaults to `603` (Decline)

140 when omitted.

141 

142### Example

143 

144```java

145package com.openai.example;

146 

147import com.openai.client.OpenAIClient;

148import com.openai.client.okhttp.OpenAIOkHttpClient;

149import com.openai.models.realtime.calls.CallRejectParams;

150 

151public final class Main {

152 private Main() {}

153 

154 public static void main(String[] args) {

155 OpenAIClient client = OpenAIOkHttpClient.fromEnv();

156 

157 client.realtime().calls().reject("call_id");

158 }

159}

160```