### GET /v1alpha/sources Source: https://developers.google.com/jules/api/reference/rest?hl=de Lists all available data sources. ```APIDOC ## GET /v1alpha/sources ### Description Lists sources. ### Method GET ### Endpoint /v1alpha/sources ``` -------------------------------- ### GET /sources Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources Retrieves a list of all sources. ```APIDOC ## GET /sources ### Description Lists sources. ### Method GET ### Endpoint `/sources` ``` -------------------------------- ### GET /v1alpha/{name=sources/**} Source: https://developers.google.com/jules/api/reference/rest Retrieves a single source. ```APIDOC ## GET /v1alpha/{name=sources/**} ### Description Gets a single source. ### Method GET ### Endpoint /v1alpha/{name=sources/**} ### Parameters #### Path Parameters - **name** (string) - Required - The source name. ``` -------------------------------- ### GET /v1alpha/{name=sources/**} Source: https://developers.google.com/jules/api/reference/rest?hl=ko Retrieves a single source. ```APIDOC ## GET /v1alpha/{name=sources/**} ### Description Gets a single source. ### Method GET ### Endpoint /v1alpha/{name=sources/**} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the source. ``` -------------------------------- ### GET /v1alpha/{parent}/activities Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions.activities/list Lists all activities for a given session. ```APIDOC ## GET /v1alpha/{parent}/activities ### Description Lists activities for a session. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{parent=sessions/*}/activities ### Parameters #### Path Parameters - **parent** (string) - Required - The parent session, which owns this collection of activities. Format: sessions/{session} #### Query Parameters - **pageSize** (integer) - Optional - The number of activities to return. Must be between 1 and 100, inclusive. Defaults to 50. - **pageToken** (string) - Optional - A page token, received from a previous activities.list call. ### Response #### Success Response (200) - **activities** (array) - The activities from the specified session. - **nextPageToken** (string) - A token, which can be sent as pageToken to retrieve the next page. #### Response Example { "activities": [ { "object": "Activity" } ], "nextPageToken": "string" } ``` -------------------------------- ### GET /v1alpha/sources Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/list?hl=ko Lists sources. Stay organized with collections. Save and categorize content based on your preferences. ```APIDOC ## GET /v1alpha/sources ### Description Lists sources. Stay organized with collections. Save and categorize content based on your preferences. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/sources ### Query Parameters - **filter** (string) - Optional. The filter expression for listing sources, based on AIP-160. If not set, all sources will be returned. Currently only supports filtering by name, which can be used to filter by a single source or multiple sources separated by OR. Example filters: - 'name=sources/source1 OR name=sources/source2' - **pageSize** (integer) - Optional. The number of sources to return. Must be between 1 and 100, inclusive. If unset, defaults to 30. If set to greater than 100, it will be coerced to 100. - **pageToken** (string) - Optional. A page token, received from a previous `sources.list` call. ### Request Body The request body must be empty. ### Response #### Success Response (200) - **sources** (array of objects) - The sources from the specified request. - **nextPageToken** (string) - A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. #### Response Example ```json { "sources": [ { "object (Source)" } ], "nextPageToken": "string" } ``` ``` -------------------------------- ### GET /v1alpha/{parent=sessions/*}/activities Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions.activities/list?hl=ko Lists activities for a session. Stay organized with collections. Save and categorize content based on your preferences. ```APIDOC ## GET /v1alpha/{parent=sessions/*}/activities ### Description Lists activities for a session. Stay organized with collections. Save and categorize content based on your preferences. ### Method GET ### Endpoint `https://jules.googleapis.com/v1alpha/{parent=sessions/*}/activities` ### Parameters #### Path Parameters - **parent** (string) - Required - The parent session, which owns this collection of activities. Format: sessions/{session} #### Query Parameters - **pageSize** (integer) - Optional - The number of activities to return. Must be between 1 and 100, inclusive. If unset, defaults to 50. If set to greater than 100, it will be coerced to 100. - **pageToken** (string) - Optional - A page token, received from a previous `activities.list` call. ### Request Body The request body must be empty. ### Response #### Success Response (200) - **activities** (array of objects) - The activities from the specified session. - **nextPageToken** (string) - A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. #### Response Example ```json { "activities": [ { "object": "Activity" } ], "nextPageToken": "string" } ``` ``` -------------------------------- ### GET /v1alpha/{parent=sessions/*}/activities Source: https://developers.google.com/jules/api/reference/rest Lists all activities associated with a session. ```APIDOC ## GET /v1alpha/{parent=sessions/*}/activities ### Description Lists activities for a session. ### Method GET ### Endpoint /v1alpha/{parent=sessions/*}/activities ### Parameters #### Path Parameters - **parent** (string) - Required - The session parent identifier. ``` -------------------------------- ### GET /v1alpha/{name=sessions/*/activities/*} Source: https://developers.google.com/jules/api/reference/rest Retrieves a single activity from a session. ```APIDOC ## GET /v1alpha/{name=sessions/*/activities/*} ### Description Gets a single activity. ### Method GET ### Endpoint /v1alpha/{name=sessions/*/activities/*} ### Parameters #### Path Parameters - **name** (string) - Required - The activity name. ``` -------------------------------- ### GET sources.get Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/get?hl=fr Retrieves a single source. Stay organized with collections by saving and categorizing content based on your preferences. ```APIDOC ## GET /v1alpha/{name=sources/**} ### Description Gets a single source. Stay organized with collections by saving and categorizing content based on your preferences. ### Method GET ### Endpoint `https://jules.googleapis.com/v1alpha/{name=sources/**}` ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the source to retrieve. Format: sources/{source}. It takes the form `sources/{+source}`. ### Request Body The request body must be empty. ### Response #### Success Response (200) If successful, the response body contains an instance of `Source`. ``` -------------------------------- ### GET /sessions/{session}/activities Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions.activities/list?hl=fr Lists all activities for a specified session. ```APIDOC ## GET /sessions/{session}/activities ### Description Lists activities for a session. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{parent=sessions/*}/activities ### Parameters #### Path Parameters - **parent** (string) - Required - The parent session, which owns this collection of activities. Format: sessions/{session} #### Query Parameters - **pageSize** (integer) - Optional - The number of activities to return. Must be between 1 and 100, inclusive. Defaults to 50. - **pageToken** (string) - Optional - A page token, received from a previous activities.list call. ### Response #### Success Response (200) - **activities** (array of objects) - The activities from the specified session. - **nextPageToken** (string) - A token, which can be sent as pageToken to retrieve the next page. #### Response Example { "activities": [ { "object": "Activity" } ], "nextPageToken": "string" } ``` -------------------------------- ### HTTP GET Request for sources.list Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/list?hl=ja The endpoint to list sources using the gRPC Transcoding syntax. ```http GET https://jules.googleapis.com/v1alpha/sources ``` -------------------------------- ### GET /v1alpha/{name=sessions/*/activities/*} Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions.activities/get?hl=de Retrieves a single activity. Activities can be saved and categorized based on user preferences. ```APIDOC ## GET /v1alpha/{name=sessions/*/activities/*} ### Description Gets a single activity. Stay organized with collections. Save and categorize content based on your preferences. ### Method GET ### Endpoint `https://jules.googleapis.com/v1alpha/{name=sessions/*/activities/*}` ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the activity to retrieve. Format: sessions/{session}/activities/{activity}. It takes the form `sessions/{session}/activities/{activities}`. ### Request Body The request body must be empty. ### Response #### Success Response (200) If successful, the response body contains an instance of `Activity`. ``` -------------------------------- ### GET /v1alpha/{parent=sessions/*}/activities Source: https://developers.google.com/jules/api/reference/rest?hl=es Lists all activities associated with a specific session. ```APIDOC ## GET /v1alpha/{parent=sessions/*}/activities ### Description Lists activities for a session. ### Method GET ### Endpoint /v1alpha/{parent=sessions/*}/activities ### Parameters #### Path Parameters - **parent** (string) - Required - The resource name of the session. ``` -------------------------------- ### GET sources/{name} Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/get?hl=es Retrieves a single source resource by its name. ```APIDOC ## GET https://jules.googleapis.com/v1alpha/{name=sources/**} ### Description Gets a single source. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{name=sources/**} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the source to retrieve. Format: sources/{source} ### Request Body The request body must be empty. ### Response #### Success Response (200) - **Source** (object) - The response body contains an instance of Source. ``` -------------------------------- ### GET /v1alpha/sessions Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/list?hl=es Lists all sessions available in the Jules API. ```APIDOC ## GET https://jules.googleapis.com/v1alpha/sessions ### Description Lists all sessions. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/sessions ### Parameters #### Query Parameters - **pageSize** (integer) - Optional - The number of sessions to return. Must be between 1 and 100, inclusive. If unset, defaults to 30. - **pageToken** (string) - Optional - A page token, received from a previous sessions.list call. ### Response #### Success Response (200) - **sessions** (array) - The sessions from the specified request. - **nextPageToken** (string) - A token, which can be sent as pageToken to retrieve the next page. #### Response Example { "sessions": [ { "object": "Session" } ], "nextPageToken": "string" } ``` -------------------------------- ### GET sessions.activities.get Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions.activities/get?hl=ko Retrieves a single activity by its resource name. ```APIDOC ## GET sessions.activities.get ### Description Gets a single activity from the Jules API. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{name=sessions/*/activities/*} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the activity to retrieve. Format: sessions/{session}/activities/{activity} ### Request Body The request body must be empty. ### Response #### Success Response (200) - **Activity** (object) - An instance of the Activity resource. ``` -------------------------------- ### GET /sessions Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=fr Lists all sessions associated with the authenticated user. ```APIDOC ## GET /sessions ### Description Lists all sessions. ### Method GET ### Endpoint `/sessions` ### Response #### Success Response (200) - A list of session objects, each containing: - `name` (string) - Output only. Identifier. The full resource name (e.g., "sessions/{session}"). - `id` (string) - Output only. The id of the session. - `prompt` (string) - The prompt used for the session. - `sourceContext` (object(`SourceContext`)) - The source context used for the session. - `title` (string) - The title of the session. - `requirePlanApproval` (boolean) - Indicates if plan approval is required. - `automationMode` (enum(`AutomationMode`)) - The automation mode of the session. - `createTime` (string(`Timestamp` format)) - Output only. The time the session was created. - `updateTime` (string(`Timestamp` format)) - Output only. The time the session was last updated. - `state` (enum(`State`)) - Output only. The state of the session. - `url` (string) - Output only. The URL of the session. - `outputs[]` (object(`SessionOutput`)) - Output only. The outputs of the session. #### Response Example ```json [ { "name": "sessions/12345", "id": "12345", "prompt": "Analyze the performance of the latest marketing campaign.", "sourceContext": { "source": "sources/campaign-data", "githubRepoContext": { "startingBranch": "main" } }, "title": "Marketing Campaign Analysis", "requirePlanApproval": true, "automationMode": "AUTO_CREATE_PR", "createTime": "2023-10-27T10:00:00Z", "updateTime": "2023-10-27T10:05:00Z", "state": "IN_PROGRESS", "url": "https://jules.example.com/sessions/12345", "outputs": [] }, { "name": "sessions/67890", "id": "67890", "prompt": "Summarize the key findings from the Q3 report.", "sourceContext": { "source": "sources/q3-report" }, "title": "Q3 Report Summary", "requirePlanApproval": false, "automationMode": "STATE_UNSPECIFIED", "createTime": "2023-10-26T09:00:00Z", "updateTime": "2023-10-26T09:15:00Z", "state": "COMPLETED", "url": "https://jules.example.com/sessions/67890", "outputs": [ { "content": "The key findings indicate a 15% increase in revenue." } ] } ] ``` ``` -------------------------------- ### GET /v1alpha/{name=sessions/*} Source: https://developers.google.com/jules/api/reference/rest Retrieves details for a specific session. ```APIDOC ## GET /v1alpha/{name=sessions/*} ### Description Gets a single session. ### Method GET ### Endpoint /v1alpha/{name=sessions/*} ### Parameters #### Path Parameters - **name** (string) - Required - The session name. ``` -------------------------------- ### GET /v1alpha/sessions Source: https://developers.google.com/jules/api/reference/rest?hl=de Retrieves a list of all available sessions. ```APIDOC ## GET /v1alpha/sessions ### Description Lists all sessions. ### Method GET ### Endpoint /v1alpha/sessions ``` -------------------------------- ### GET /v1alpha/{name=sessions/*} Source: https://developers.google.com/jules/api/reference/rest?hl=ko Retrieves a single session by its name. ```APIDOC ## GET /v1alpha/{name=sessions/*} ### Description Gets a single session. ### Method GET ### Endpoint /v1alpha/{name=sessions/*} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the session. ``` -------------------------------- ### GET /v1alpha/{name=sessions/*/activities/*} Source: https://developers.google.com/jules/api/reference/rest?hl=de Retrieves details for a specific activity within a session. ```APIDOC ## GET /v1alpha/{name=sessions/*/activities/*} ### Description Gets a single activity. ### Method GET ### Endpoint /v1alpha/{name=sessions/*/activities/*} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the activity. ``` -------------------------------- ### GET /sources/{source} Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources Retrieves a single source by its ID. ```APIDOC ## GET /sources/{source} ### Description Gets a single source. ### Method GET ### Endpoint `/sources/{source}` ``` -------------------------------- ### GET /v1alpha/sources Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/list?hl=de Lists all sources available in the Jules API, with support for filtering and pagination. ```APIDOC ## GET https://jules.googleapis.com/v1alpha/sources ### Description Lists sources. The request retrieves a collection of sources based on optional filter criteria. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/sources ### Parameters #### Query Parameters - **filter** (string) - Optional - The filter expression for listing sources, based on AIP-160. Supports filtering by name. - **pageSize** (integer) - Optional - The number of sources to return (1-100). Defaults to 30. - **pageToken** (string) - Optional - A page token, received from a previous sources.list call. ### Request Body The request body must be empty. ### Response #### Success Response (200) - **sources** (array of objects) - The sources from the specified request. - **nextPageToken** (string) - A token, which can be sent as pageToken to retrieve the next page. #### Response Example { "sources": [ { "name": "sources/source1" } ], "nextPageToken": "token_string" } ``` -------------------------------- ### GET /v1alpha/sources/{name} Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/get?hl=ko Retrieves a single source resource by its name. ```APIDOC ## GET https://jules.googleapis.com/v1alpha/{name=sources/**} ### Description Gets a single source resource based on the provided name. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{name=sources/**} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the source to retrieve. Format: sources/{source} ### Request Body The request body must be empty. ### Response #### Success Response (200) - **Source** (object) - The response body contains an instance of Source. ``` -------------------------------- ### GET /sessions/{session} Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=fr Retrieves a specific session by its resource name. ```APIDOC ## GET /sessions/{session} ### Description Retrieves a specific session. ### Method GET ### Endpoint `/sessions/{session}` ### Parameters #### Path Parameters - **session** (string) - Required - The resource name of the session to retrieve (e.g., "sessions/12345"). ### Response #### Success Response (200) - `name` (string) - Output only. Identifier. The full resource name (e.g., "sessions/{session}"). - `id` (string) - Output only. The id of the session. - `prompt` (string) - The prompt used for the session. - `sourceContext` (object(`SourceContext`)) - The source context used for the session. - `title` (string) - The title of the session. - `requirePlanApproval` (boolean) - Indicates if plan approval is required. - `automationMode` (enum(`AutomationMode`)) - The automation mode of the session. - `createTime` (string(`Timestamp` format)) - Output only. The time the session was created. - `updateTime` (string(`Timestamp` format)) - Output only. The time the session was last updated. - `state` (enum(`State`)) - Output only. The state of the session. - `url` (string) - Output only. The URL of the session. - `outputs[]` (object(`SessionOutput`)) - Output only. The outputs of the session. #### Response Example ```json { "name": "sessions/12345", "id": "12345", "prompt": "Analyze the performance of the latest marketing campaign.", "sourceContext": { "source": "sources/campaign-data", "githubRepoContext": { "startingBranch": "main" } }, "title": "Marketing Campaign Analysis", "requirePlanApproval": true, "automationMode": "AUTO_CREATE_PR", "createTime": "2023-10-27T10:00:00Z", "updateTime": "2023-10-27T10:05:00Z", "state": "IN_PROGRESS", "url": "https://jules.example.com/sessions/12345", "outputs": [] } ``` ``` -------------------------------- ### GET /sessions/{parent}/activities Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions.activities/list?hl=de Retrieves a list of activities for a specified session. ```APIDOC ## GET /sessions/{parent}/activities ### Description Lists activities for a session. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{parent=sessions/*}/activities ### Parameters #### Path Parameters - **parent** (string) - Required - The parent session, which owns this collection of activities. Format: sessions/{session} #### Query Parameters - **pageSize** (integer) - Optional - The number of activities to return. Must be between 1 and 100, inclusive. Defaults to 50. - **pageToken** (string) - Optional - A page token, received from a previous activities.list call. ### Response #### Success Response (200) - **activities** (array of objects) - The activities from the specified session. - **nextPageToken** (string) - A token, which can be sent as pageToken to retrieve the next page. #### Response Example { "activities": [ { "object": "Activity" } ], "nextPageToken": "string" } ``` -------------------------------- ### GET sessions.activities.get Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions.activities/get Retrieves a single activity resource based on the provided session and activity identifiers. ```APIDOC ## GET sessions.activities.get ### Description Gets a single activity. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{name=sessions/*/activities/*} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the activity to retrieve. Format: sessions/{session}/activities/{activity} ### Request Body The request body must be empty. ### Response #### Success Response (200) - **Activity** (object) - An instance of the Activity resource. ``` -------------------------------- ### GET /v1alpha/sources Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/list Retrieves a list of sources based on optional filter, page size, and pagination token parameters. ```APIDOC ## GET https://jules.googleapis.com/v1alpha/sources ### Description Lists sources available in the Jules API. Supports filtering and pagination. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/sources ### Parameters #### Query Parameters - **filter** (string) - Optional - The filter expression for listing sources, based on AIP-160. - **pageSize** (integer) - Optional - The number of sources to return (1-100). Defaults to 30. - **pageToken** (string) - Optional - A page token received from a previous call to retrieve the next page. ### Response #### Success Response (200) - **sources** (array) - The list of Source objects. - **nextPageToken** (string) - A token to retrieve the next page of results, if available. #### Response Example { "sources": [ { "name": "sources/source1" } ], "nextPageToken": "token_string" } ``` -------------------------------- ### GET /v1alpha/sessions Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/list?hl=pt-br Retrieves a list of all sessions, supporting pagination via pageSize and pageToken. ```APIDOC ## GET https://jules.googleapis.com/v1alpha/sessions ### Description Lists all sessions available in the system. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/sessions ### Parameters #### Query Parameters - **pageSize** (integer) - Optional - The number of sessions to return. Must be between 1 and 100. Defaults to 30. - **pageToken** (string) - Optional - A page token received from a previous call to retrieve the next page. ### Response #### Success Response (200) - **sessions** (array of objects) - The sessions from the specified request. - **nextPageToken** (string) - A token to retrieve the next page of results. #### Response Example { "sessions": [ { "object": "Session" } ], "nextPageToken": "string" } ``` -------------------------------- ### POST /sessions Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=fr Creates a new session with the specified prompt and source context. Optional parameters include title, requirePlanApproval, and automationMode. ```APIDOC ## POST /sessions ### Description Creates a new session. ### Method POST ### Endpoint `/sessions` ### Parameters #### Request Body - `prompt` (string) - Required. The prompt to start the session with. - `sourceContext` (object(`SourceContext`)) - Required. The source to use in this session, with additional context. - `title` (string) - Optional. If not provided, the system will generate one. - `requirePlanApproval` (boolean) - Optional. Input only. If true, plans the agent generates will require explicit plan approval before the agent starts working. If not set, plans will be auto-approved. - `automationMode` (enum(`AutomationMode`)) - Optional. Input only. The automation mode of the session. If not set, the default automation mode will be used. ### Request Example ```json { "prompt": "Analyze the performance of the latest marketing campaign.", "sourceContext": { "source": "sources/campaign-data", "githubRepoContext": { "startingBranch": "main" } }, "title": "Marketing Campaign Analysis", "requirePlanApproval": true, "automationMode": "AUTO_CREATE_PR" } ``` ### Response #### Success Response (200) - `name` (string) - Output only. Identifier. The full resource name (e.g., "sessions/{session}"). - `id` (string) - Output only. The id of the session. - `prompt` (string) - The prompt used for the session. - `sourceContext` (object(`SourceContext`)) - The source context used for the session. - `title` (string) - The title of the session. - `requirePlanApproval` (boolean) - Indicates if plan approval is required. - `automationMode` (enum(`AutomationMode`)) - The automation mode of the session. - `createTime` (string(`Timestamp` format)) - Output only. The time the session was created. - `updateTime` (string(`Timestamp` format)) - Output only. The time the session was last updated. - `state` (enum(`State`)) - Output only. The state of the session. - `url` (string) - Output only. The URL of the session. - `outputs[]` (object(`SessionOutput`)) - Output only. The outputs of the session. #### Response Example ```json { "name": "sessions/12345", "id": "12345", "prompt": "Analyze the performance of the latest marketing campaign.", "sourceContext": { "source": "sources/campaign-data", "githubRepoContext": { "startingBranch": "main" } }, "title": "Marketing Campaign Analysis", "requirePlanApproval": true, "automationMode": "AUTO_CREATE_PR", "createTime": "2023-10-27T10:00:00Z", "updateTime": "2023-10-27T10:05:00Z", "state": "IN_PROGRESS", "url": "https://jules.example.com/sessions/12345", "outputs": [] } ``` ``` -------------------------------- ### POST /sessions Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=de Creates a new session with the specified prompt and source context. ```APIDOC ## POST /sessions ### Description Creates a new session with the specified prompt and source context. ### Method POST ### Endpoint `/sessions` ### Parameters #### Request Body - **prompt** (string) - Required. The prompt to start the session with. - **sourceContext** (object (`SourceContext`)) - Required. The source to use in this session, with additional context. - **title** (string) - Optional. If not provided, the system will generate one. - **requirePlanApproval** (boolean) - Optional. Input only. If true, plans the agent generates will require explicit plan approval before the agent starts working. If not set, plans will be auto-approved. - **automationMode** (enum (`AutomationMode`)) - Optional. Input only. The automation mode of the session. If not set, the default automation mode will be used. ### Request Example ```json { "prompt": "Analyze the code in the repository.", "sourceContext": { "source": "sources/my-source", "githubRepoContext": { "startingBranch": "main" } }, "title": "Code Analysis Session", "requirePlanApproval": true, "automationMode": "AUTO_CREATE_PR" } ``` ### Response #### Success Response (200) - **name** (string) - Output only. Identifier. The full resource name (e.g., "sessions/{session}"). - **id** (string) - Output only. The id of the session. This is the same as the "{session}" part of the resource name (e.g., "sessions/{session}"). - **prompt** (string) - Required. The prompt to start the session with. - **sourceContext** (object (`SourceContext`)) - Required. The source to use in this session, with additional context. - **title** (string) - Optional. If not provided, the system will generate one. - **requirePlanApproval** (boolean) - Optional. Input only. If true, plans the agent generates will require explicit plan approval before the agent starts working. If not set, plans will be auto-approved. - **automationMode** (enum (`AutomationMode`)) - Optional. Input only. The automation mode of the session. If not set, the default automation mode will be used. - **createTime** (string (`Timestamp` format)) - Output only. The time the session was created. - **updateTime** (string (`Timestamp` format)) - Output only. The time the session was last updated. - **state** (enum (`State`)) - Output only. The state of the session. - **url** (string) - Output only. The URL of the session to view the session in the Jules web app. - **outputs** (array of objects (`SessionOutput`)) - Output only. The outputs of the session, if any. #### Response Example ```json { "name": "sessions/12345", "id": "12345", "prompt": "Analyze the code in the repository.", "sourceContext": { "source": "sources/my-source", "githubRepoContext": { "startingBranch": "main" } }, "title": "Code Analysis Session", "requirePlanApproval": true, "automationMode": "AUTO_CREATE_PR", "createTime": "2023-10-27T10:00:00Z", "updateTime": "2023-10-27T10:05:00Z", "state": "PLANNING", "url": "https://jules.example.com/sessions/12345", "outputs": [] } ``` ``` -------------------------------- ### GET /sources/{sourceId} Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources?hl=id Retrieves a single source by its ID. ```APIDOC ## GET /sources/{sourceId} ### Description Gets a single source. ### Method GET ### Endpoint `/sources/{sourceId}` ### Parameters #### Path Parameters * `sourceId` (string) - Required - The ID of the source to retrieve. ``` -------------------------------- ### Methods Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources?hl=de Available methods for interacting with the Source resource. ```APIDOC ## Methods ### `get` Gets a single source. ### `list` Lists sources. ``` -------------------------------- ### Resource: Session Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=ko Represents a contiguous amount of work within the same context. It includes details about the prompt, source context, automation mode, state, and outputs. ```APIDOC ## Resource: Session A session is a contiguous amount of work within the same context. ### JSON Representation ```json { "name": string, "id": string, "prompt": string, "sourceContext": { "object": "SourceContext" }, "title": string, "requirePlanApproval": boolean, "automationMode": enum("AutomationMode"), "createTime": string, "updateTime": string, "state": enum("State"), "url": string, "outputs": [ { "object": "SessionOutput" } ] } ``` ### Fields * `name` (string) - Output only. Identifier. The full resource name (e.g., "sessions/{session}"). * `id` (string) - Output only. The id of the session. This is the same as the "{session}" part of the resource name (e.g., "sessions/{session}"). * `prompt` (string) - Required. The prompt to start the session with. * `sourceContext` (object(`SourceContext`)) - Required. The source to use in this session, with additional context. * `title` (string) - Optional. If not provided, the system will generate one. * `requirePlanApproval` (boolean) - Input only. If true, plans the agent generates will require explicit plan approval before the agent starts working. If not set, plans will be auto-approved. * `automationMode` (enum(`AutomationMode`)) - Input only. The automation mode of the session. If not set, the default automation mode will be used. * `createTime` (string (`Timestamp` format)) - Output only. The time the session was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". * `updateTime` (string (`Timestamp` format)) - Output only. The time the session was last updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". * `state` (enum(`State`)) - Output only. The state of the session. * `url` (string) - Output only. The URL of the session to view the session in the Jules web app. * `outputs[]` (object(`SessionOutput`)) - Output only. The outputs of the session, if any. ``` -------------------------------- ### Resource: Session Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=zh-cn Represents a contiguous amount of work within the same context. It includes details about the prompt, source context, automation mode, and state. ```APIDOC ## Resource: Session A session is a contiguous amount of work within the same context. ### JSON Representation ```json { "name": string, "id": string, "prompt": string, "sourceContext": { "object": "SourceContext" }, "title": string, "requirePlanApproval": boolean, "automationMode": "AutomationMode", "createTime": string, "updateTime": string, "state": "State", "url": string, "outputs": [ { "object": "SessionOutput" } ] } ``` ### Fields - **name** (string) - Output only. Identifier. The full resource name (e.g., "sessions/{session}"). - **id** (string) - Output only. The id of the session. This is the same as the "{session}" part of the resource name (e.g., "sessions/{session}"). - **prompt** (string) - Required. The prompt to start the session with. - **sourceContext** (object (SourceContext)) - Required. The source to use in this session, with additional context. - **title** (string) - Optional. If not provided, the system will generate one. - **requirePlanApproval** (boolean) - Optional. Input only. If true, plans the agent generates will require explicit plan approval before the agent starts working. If not set, plans will be auto-approved. - **automationMode** (enum (AutomationMode)) - Optional. Input only. The automation mode of the session. If not set, the default automation mode will be used. - **createTime** (string (`Timestamp` format)) - Output only. The time the session was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". - **updateTime** (string (`Timestamp` format)) - Output only. The time the session was last updated. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30". - **state** (enum (State)) - Output only. The state of the session. - **url** (string) - Output only. The URL of the session to view the session in the Jules web app. - **outputs** (array of objects (SessionOutput)) - Output only. The outputs of the session, if any. ``` -------------------------------- ### GET /v1alpha/sessions/{name} Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/get?hl=de Retrieves a single session resource by its name. ```APIDOC ## GET https://jules.googleapis.com/v1alpha/{name=sessions/*} ### Description Gets a single session. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/{name=sessions/*} ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the session to retrieve. Format: sessions/{session} ### Request Body The request body must be empty. ### Response #### Success Response (200) - **Session** (object) - An instance of the Session resource. ``` -------------------------------- ### POST /v1alpha/{session=sessions/*}:approvePlan Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/approvePlan?hl=es Approves a plan in a session. ```APIDOC ## POST /v1alpha/{session=sessions/*}:approvePlan ### Description Approves a plan in a session. ### Method POST ### Endpoint https://jules.googleapis.com/v1alpha/{session=sessions/*}:approvePlan ### Parameters #### Path Parameters - **session** (string) - Required - The resource name of the session to approve the plan in. Format: sessions/{session} ### Request Body The request body must be empty. ### Response #### Success Response (200) - The response body is empty. ``` -------------------------------- ### POST /sessions/{session}:approvePlan Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/approvePlan?hl=id Approves a plan in a session. This endpoint uses gRPC Transcoding syntax. ```APIDOC ## POST /sessions/{session}:approvePlan ### Description Approves a plan in a session. ### Method POST ### Endpoint https://jules.googleapis.com/v1alpha/{session=sessions/*}:approvePlan ### Parameters #### Path Parameters - **session** (string) - Required - The resource name of the session to approve the plan in. Format: sessions/{session} ### Request Body The request body must be empty. ### Response #### Success Response (200) - The response body is empty. ``` -------------------------------- ### sources.get Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sources/get?hl=id Retrieves a single source. Stay organized with collections by saving and categorizing content based on your preferences. ```APIDOC ## GET /v1alpha/{name=sources/**} ### Description Gets a single source. ### Method GET ### Endpoint `https://jules.googleapis.com/v1alpha/{name=sources/**}` ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the source to retrieve. Format: sources/{source} It takes the form sources/{+source}. ### Request Body The request body must be empty. ### Response #### Success Response (200) If successful, the response body contains an instance of `Source`. ``` -------------------------------- ### POST /v1alpha/{session}:approvePlan Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/approvePlan?hl=de Approves a plan in a session using the Jules API. ```APIDOC ## POST /v1alpha/{session}:approvePlan ### Description Approves a plan in a session. ### Method POST ### Endpoint https://jules.googleapis.com/v1alpha/{session=sessions/*}:approvePlan ### Parameters #### Path Parameters - **session** (string) - Required - The resource name of the session to approve the plan in. Format: sessions/{session} ### Request Body The request body must be empty. ### Response #### Success Response (200) - The response body is empty. ``` -------------------------------- ### Session Management Methods Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=pt-br Overview of available methods for interacting with session resources. ```APIDOC ## Session Methods ### approvePlan Approves a plan in a session. ### create Creates a new session. ### get Gets a single session. ### list Lists all sessions. ### sendMessage Sends a message from the user to a session. ``` -------------------------------- ### POST /v1alpha/sessions Source: https://developers.google.com/jules/api/reference/rest?hl=de Creates a new session for managing asynchronous coding tasks. ```APIDOC ## POST /v1alpha/sessions ### Description Creates a new session. ### Method POST ### Endpoint /v1alpha/sessions ``` -------------------------------- ### sessions.get Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/get?hl=ru Retrieves a single session, allowing users to stay organized by saving and categorizing content. ```APIDOC ## GET sessions.get ### Description Gets a single session. Stay organized with collections. Save and categorize content based on your preferences. ### Method GET ### Endpoint `https://jules.googleapis.com/v1alpha/{name=sessions/*}` ### Parameters #### Path Parameters - **name** (string) - Required - The resource name of the session to retrieve. Format: sessions/{session}. It takes the form `sessions/{session}`. ### Request Body The request body must be empty. ### Response #### Success Response (200) If successful, the response body contains an instance of `Session`. ``` -------------------------------- ### List Sessions Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/list?hl=ru Lists all sessions, allowing for organization and categorization of content based on user preferences. Supports pagination. ```APIDOC ## GET /v1alpha/sessions ### Description Lists all sessions. Stay organized with collections. Save and categorize content based on your preferences. ### Method GET ### Endpoint https://jules.googleapis.com/v1alpha/sessions ### Query Parameters - **pageSize** (integer) - Optional. The number of sessions to return. Must be between 1 and 100, inclusive. If unset, defaults to 30. If set to greater than 100, it will be coerced to 100. - **pageToken** (string) - Optional. A page token, received from a previous `sessions.list` call. ### Request Body The request body must be empty. ### Response #### Success Response (200) - **sessions[]** (object) - The sessions from the specified request. - **nextPageToken** (string) - A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. #### Response Example ```json { "sessions": [ { "object (Session)" } ], "nextPageToken": "string" } ``` ``` -------------------------------- ### POST /v1alpha/sessions Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions/create?hl=es Creates a new session in the Jules API. ```APIDOC ## POST /v1alpha/sessions ### Description Creates a new session. ### Method POST ### Endpoint https://jules.googleapis.com/v1alpha/sessions ### Request Body - **Session** (object) - Required - An instance of Session. ### Response #### Success Response (200) - **Session** (object) - The newly created instance of Session. ``` -------------------------------- ### Methods for Session Source: https://developers.google.com/jules/api/reference/rest/v1alpha/sessions?hl=zh-cn Available methods for interacting with the Session resource. ```APIDOC ## Methods for Session ### approvePlan Approves the plan generated by the agent for a session. ### create Creates a new session. ### get Retrieves a session. ### list Lists sessions. ### sendMessage Sends a message to the agent in a session. ```