@rippling/rippling-sdk 0.2.0-alpha.107 → 0.2.0-alpha.109

package/src/resources/spend-categories.ts

@@ -0,0 +1,175 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as BusinessPartnersAPI from './business-partners';
+import { APIPromise } from '../core/api-promise';
+import { PageCursorURL, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class SpendCategories extends APIResource {
+  /**
+   * A list of spend categories.
+   *
+   * - Requires: `Internal Testing`
+   * - Filterable fields: `name`
+   * - Sortable fields: `id`, `created_at`, `updated_at`
+   *
+   * @example HTTP
+   * Representative request and response shapes.
+   * ```
+   * GET /spend-categories/?filter=filter&order_by=order_by&limit=50&cursor=cursor HTTP/1.1
+   * Host: rest.ripplingapis.com
+   * Accept: application/json
+   * Rippling-Api-Version: 2024-08-01
+   *
+   * HTTP/1.1 200 OK
+   * Content-Type: application/json
+   *
+   * {
+   *   "__meta": {
+   *     "redacted_fields": [
+   *       {
+   *         "name": "date_of_birth",
+   *         "reason": "Insufficient entitlements"
+   *       }
+   *     ]
+   *   },
+   *   "results": [
+   *     {
+   *       "id": "string",
+   *       "created_at": "string",
+   *       "updated_at": "string",
+   *       "name": "string",
+   *       "active": false
+   *     }
+   *   ],
+   *   "next_link": "string"
+   * }
+   * ```
+   */
+  list(
+    query: SpendCategoryListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<SpendCategoryListResponsesPageCursorURL, SpendCategoryListResponse> {
+    return this._client.getAPIList('/spend-categories/', PageCursorURL<SpendCategoryListResponse>, {
+      query,
+      ...options,
+    });
+  }
+
+  /**
+   * Retrieve a specific spend category
+   *
+   * @example HTTP
+   * Representative request and response shapes.
+   * ```
+   * GET /spend-categories/{id}/ HTTP/1.1
+   * Host: rest.ripplingapis.com
+   * Accept: application/json
+   * Rippling-Api-Version: 2024-08-01
+   *
+   * HTTP/1.1 200 OK
+   * Content-Type: application/json
+   *
+   * {
+   *   "__meta": {
+   *     "redacted_fields": [
+   *       {}
+   *     ]
+   *   }
+   * }
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<SpendCategoryRetrieveResponse> {
+    return this._client.get(path`/spend-categories/${id}/`, options);
+  }
+}
+
+export type SpendCategoryListResponsesPageCursorURL = PageCursorURL<SpendCategoryListResponse>;
+
+/**
+ * A Spend category used to classify transaction line items.
+ *
+ *     Inactive categories are included so historical transactions can still resolve their category.
+ */
+export interface SpendCategoryListResponse {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * Whether the category is active. Inactive categories remain available for
+   * historical references.
+   */
+  active?: boolean;
+
+  /**
+   * Name of the Spend category.
+   */
+  name?: string;
+}
+
+/**
+ * Meta information for the response.
+ */
+export interface SpendCategoryRetrieveResponse extends BusinessPartnersAPI.Meta {
+  /**
+   * Identifier field
+   */
+  id: string;
+
+  /**
+   * Record creation date
+   */
+  created_at: string;
+
+  /**
+   * Record update date
+   */
+  updated_at: string;
+
+  /**
+   * Whether the category is active. Inactive categories remain available for
+   * historical references.
+   */
+  active?: boolean;
+
+  /**
+   * Name of the Spend category.
+   */
+  name?: string;
+}
+
+export interface SpendCategoryListParams {
+  cursor?: string;
+
+  filter?: string;
+
+  /**
+   * The maximum number of results to return. Defaults to 50. Maximum is 100.
+   */
+  limit?: number;
+
+  order_by?: string;
+}
+
+export declare namespace SpendCategories {
+  export {
+    type SpendCategoryListResponse as SpendCategoryListResponse,
+    type SpendCategoryRetrieveResponse as SpendCategoryRetrieveResponse,
+    type SpendCategoryListResponsesPageCursorURL as SpendCategoryListResponsesPageCursorURL,
+    type SpendCategoryListParams as SpendCategoryListParams,
+  };
+}

package/src/resources/workflows/executions.ts

@@ -0,0 +1,191 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Execute workflow actions like sending emails, Slack messages, and notifications
+ */
+export class Executions extends APIResource {
+  /**
+   * Launches a new execution of the workflow's current published version. The
+   * workflow must use a manual trigger and be published and enabled, and the
+   * caller's role must have permission to run it. The request body must be empty:
+   * manual workflow executions accept no input parameters. Executions are not
+   * idempotent: every successful call starts a real execution with real side effects
+   * (messages, callbacks), and a duplicate request starts a second execution. Do not
+   * retry automatically; check an execution's status with GET
+   * /workflows/{id}/executions/{execution_id} instead.
+   *
+   * @example HTTP
+   * Representative request and response shapes.
+   * ```
+   * POST /workflows/{id}/executions/ HTTP/1.1
+   * Host: rest.ripplingapis.com
+   * Accept: application/json
+   * Rippling-Api-Version: 2024-08-01
+   *
+   * HTTP/1.1 201 Created
+   * Content-Type: application/json
+   *
+   * {
+   *   "id": "string",
+   *   "workflow_id": "string",
+   *   "version_id": "string",
+   *   "status": "pending",
+   *   "created_at": "2025-01-01T00:00:00Z"
+   * }
+   * ```
+   */
+  create(id: string, options?: RequestOptions): APIPromise<ExecutionCreateResponse> {
+    return this._client.post(path`/workflows/${id}/executions/`, options);
+  }
+
+  /**
+   * Returns a workflow execution's current status. Poll until the status reaches a
+   * terminal value (`completed`, `failed`, or `cancelled`); all other values are
+   * transitional.
+   *
+   * @example HTTP
+   * Representative request and response shapes.
+   * ```
+   * GET /workflows/{id}/executions/{execution_id}/ HTTP/1.1
+   * Host: rest.ripplingapis.com
+   * Accept: application/json
+   * Rippling-Api-Version: 2024-08-01
+   *
+   * HTTP/1.1 200 OK
+   * Content-Type: application/json
+   *
+   * {
+   *   "id": "string",
+   *   "workflow_id": "string",
+   *   "version_id": "string",
+   *   "status": "pending",
+   *   "created_at": "2025-01-01T00:00:00Z"
+   * }
+   * ```
+   */
+  retrieve(id: string, executionID: string, options?: RequestOptions): APIPromise<ExecutionRetrieveResponse> {
+    return this._client.get(path`/workflows/${id}/executions/${executionID}/`, options);
+  }
+}
+
+/**
+ * A single execution of a workflow: one launch of the workflow's current published
+ * version, with a status to poll until it reaches a terminal value.
+ */
+export interface ExecutionCreateResponse {
+  /**
+   * Unique identifier for this workflow execution. Poll it with GET
+   * /workflows/{id}/executions/{execution_id}.
+   */
+  id: string;
+
+  /**
+   * When the workflow was launched, in UTC (ISO 8601).
+   */
+  created_at: string;
+
+  /**
+   * The execution status. Transitional values are `pending`, `in_progress`,
+   * `waiting_for_response`, and `cancellation_pending`; terminal values are
+   * `completed`, `failed`, and `cancelled`. Poll until the status reaches a terminal
+   * value.
+   *
+   * - `pending`: The execution is queued and has not started.
+   * - `in_progress`: The workflow is executing.
+   * - `waiting_for_response`: The execution is paused on a human input or approval
+   *   step.
+   * - `cancellation_pending`: A cancellation was requested and is being applied.
+   * - `completed`: Every step finished successfully.
+   * - `failed`: The execution stopped on an error.
+   * - `cancelled`: The execution was cancelled before completing.
+   * - `unknown`: The status could not be mapped. Contact support if this persists.
+   */
+  status:
+    | 'pending'
+    | 'in_progress'
+    | 'completed'
+    | 'failed'
+    | 'cancelled'
+    | 'cancellation_pending'
+    | 'waiting_for_response'
+    | 'unknown';
+
+  /**
+   * The workflow version that ran. An execution always runs the workflow's current
+   * published version; the current version_id is available from GET /workflows/{id}.
+   */
+  version_id: string;
+
+  /**
+   * The ID of the workflow this execution belongs to. Matches the {id} path
+   * parameter.
+   */
+  workflow_id: string;
+}
+
+/**
+ * A single execution of a workflow: one launch of the workflow's current published
+ * version, with a status to poll until it reaches a terminal value.
+ */
+export interface ExecutionRetrieveResponse {
+  /**
+   * Unique identifier for this workflow execution. Poll it with GET
+   * /workflows/{id}/executions/{execution_id}.
+   */
+  id: string;
+
+  /**
+   * When the workflow was launched, in UTC (ISO 8601).
+   */
+  created_at: string;
+
+  /**
+   * The execution status. Transitional values are `pending`, `in_progress`,
+   * `waiting_for_response`, and `cancellation_pending`; terminal values are
+   * `completed`, `failed`, and `cancelled`. Poll until the status reaches a terminal
+   * value.
+   *
+   * - `pending`: The execution is queued and has not started.
+   * - `in_progress`: The workflow is executing.
+   * - `waiting_for_response`: The execution is paused on a human input or approval
+   *   step.
+   * - `cancellation_pending`: A cancellation was requested and is being applied.
+   * - `completed`: Every step finished successfully.
+   * - `failed`: The execution stopped on an error.
+   * - `cancelled`: The execution was cancelled before completing.
+   * - `unknown`: The status could not be mapped. Contact support if this persists.
+   */
+  status:
+    | 'pending'
+    | 'in_progress'
+    | 'completed'
+    | 'failed'
+    | 'cancelled'
+    | 'cancellation_pending'
+    | 'waiting_for_response'
+    | 'unknown';
+
+  /**
+   * The workflow version that ran. An execution always runs the workflow's current
+   * published version; the current version_id is available from GET /workflows/{id}.
+   */
+  version_id: string;
+
+  /**
+   * The ID of the workflow this execution belongs to. Matches the {id} path
+   * parameter.
+   */
+  workflow_id: string;
+}
+
+export declare namespace Executions {
+  export {
+    type ExecutionCreateResponse as ExecutionCreateResponse,
+    type ExecutionRetrieveResponse as ExecutionRetrieveResponse,
+  };
+}

package/src/resources/workflows/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Executions, type ExecutionCreateResponse, type ExecutionRetrieveResponse } from './executions';
+export {
+  Workflows,
+  type WorkflowListResponse,
+  type WorkflowCreateResponse,
+  type WorkflowRetrieveResponse,
+  type WorkflowUpdateResponse,
+  type WorkflowListParams,
+  type WorkflowCreateParams,
+  type WorkflowRetrieveParams,
+  type WorkflowUpdateParams,
+  type WorkflowListResponsesPageCursorURL,
+} from './workflows';