Deployments

The Deployments service collection provides operations for querying deployment and release information. Retrieve deployment resources by ID, query release notes and releases, and search for release-note IDs using FQL filters.

Language	Last Update
Python	v1.6.5
PowerShell
Go	v0.22.0
TypeScript	v0.6.0
Rust	v0.7.1
Ruby	v1.4.0

---

---

Table of Contents

Operation	Description
CombinedReleaseNotesV1 query_release_notes	Queries for release-notes resources and returns details
CombinedReleasesV1Mixin0 query_releases	Queries for releases resources and returns details
GetDeploymentsExternalV1 get_deployments	Get deployment resources by ids
GetEntityIDsByQueryPOST get_release_notes_v1	returns the release notes for the IDs in the request
GetEntityIDsByQueryPOSTV2 get_release_notes	returns the release notes for the IDs in the request with EA and GA dates in ISO 8601 format
QueryReleaseNotesV1 query_release_note_ids	Queries for release-notes resources and returns ids

---

CombinedReleaseNotesV1

Queries for release-notes resources and returns details

Method GET

Route /deployment-coordinator/combined/release-notes/v1

Scope Deployment Coordinator: READ

PEP 8 query_release_notes

Parameters

filter query · string

FQL query specifying filter parameters.

limit query · integer

Maximum number of records to return.

offset query · string

Starting pagination offset of records to return.

sort query · string

Sort items by providing a comma separated list of property and direction (eg name.desc,time.asc). If direction is omitted, defaults to descending.

parameters query · dictionary

Full query string parameters payload in JSON format. Not required when using other keywords.

Authorization body · string

authorization header.

Code Examples

Python

PEP 8

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

response = falcon.query_release_notes(filter="string",
                                      limit=integer,
                                      offset="string",
                                      sort="string",
                                      Authorization="string")
print(response)

Operation ID

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

response = falcon.CombinedReleaseNotesV1(filter="string",
                                         limit=integer,
                                         offset="string",
                                         sort="string",
                                         Authorization="string")
print(response)

Uber

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("CombinedReleaseNotesV1",
                          filter="string",
                          limit=integer,
                          offset="string",
                          sort="string")
print(response)

PowerShell

Examples coming soon.

Go

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/release_notes"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  limit := int64(0)
  offset := "string"
  sort := "string"

  response, err := client.ReleaseNotes.CombinedReleaseNotesV1(
    &release_notes.CombinedReleaseNotesV1Params{
      Filter: "string",
      Limit: &limit,
      Offset: &offset,
      Sort: &sort,
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

TypeScript

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.releaseNotes.combinedReleaseNotesV1(
  "string",  // authorization
  "string",  // xCSUSERNAME
  "string",  // filter
  integer,  // limit
  "string",  // offset
  "string"  // sort
);

console.log(response);

Rust

use rusty_falcon::apis::release_notes_api::combined_release_notes_v1;
use rusty_falcon::easy::client::FalconHandle;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let response = combined_release_notes_v1(
        &falcon.cfg,  // configuration
        "string",  // authorization
        Some("string"),  // x_cs_username
        Some("string"),  // filter
        Some(integer),  // limit
        Some("string"),  // offset
        Some("string"),  // sort
    ).await.expect("API call failed");

    println!("{:?}", response);
}

Ruby

Examples coming soon.

Responses

200 OK

[
  {
    "categories": [],
    "early_access": "string",
    "general_availability": "string",
    "notes": [],
    "timestamp": "string",
    "version": "string"
  }
]

400 Bad Request

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

403 Forbidden

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

404 Not Found

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

429 Too Many Requests

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

500 Internal Server Error

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

---

---

CombinedReleasesV1Mixin0

Queries for releases resources and returns details

Method GET

Route /deployment-coordinator/combined/releases/v1

Scope Deployment Coordinator: READ

PEP 8 query_releases

Parameters

filter query · string

FQL query specifying filter parameters.

limit query · integer

Maximum number of records to return.

offset query · string

Starting pagination offset of records to return.

sort query · string

Sort items by providing a comma separated list of property and direction (eg name.desc,time.asc). If direction is omitted, defaults to descending.

parameters query · dictionary

Full query string parameters payload in JSON format. Not required when using other keywords.

Authorization body · string

authorization header.

Code Examples

Python

PEP 8

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

response = falcon.query_releases(filter="string",
                                 limit=integer,
                                 offset="string",
                                 sort="string",
                                 Authorization="string")
print(response)

Operation ID

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

response = falcon.CombinedReleasesV1Mixin0(filter="string",
                                           limit=integer,
                                           offset="string",
                                           sort="string",
                                           Authorization="string")
print(response)

Uber

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("CombinedReleasesV1Mixin0",
                          filter="string",
                          limit=integer,
                          offset="string",
                          sort="string")
print(response)

PowerShell

Examples coming soon.

Go

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/releases"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  limit := int64(0)
  offset := "string"
  sort := "string"

  response, err := client.Releases.CombinedReleasesV1Mixin0(
    &releases.CombinedReleasesV1Mixin0Params{
      Filter: "string",
      Limit: &limit,
      Offset: &offset,
      Sort: &sort,
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

TypeScript

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.releases.combinedReleasesV1Mixin0(
  "string",  // authorization
  "string",  // xCSUSERNAME
  "string",  // filter
  integer,  // limit
  "string",  // offset
  "string"  // sort
);

console.log(response);

Rust

use rusty_falcon::apis::releases_api::combined_releases_v1_mixin0;
use rusty_falcon::easy::client::FalconHandle;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let response = combined_releases_v1_mixin0(
        &falcon.cfg,  // configuration
        "string",  // authorization
        Some("string"),  // x_cs_username
        Some("string"),  // filter
        Some(integer),  // limit
        Some("string"),  // offset
        Some("string"),  // sort
    ).await.expect("API call failed");

    println!("{:?}", response);
}

Ruby

Examples coming soon.

Responses

200 OK

[
  {
    "annotation": "string",
    "created_by": "string",
    "created_timestamp": "string",
    "deployed_timestamp": "string",
    "deployment_start_timestamp": "string",
    "id": "string",
    "last_modified_by": "string",
    "last_modified_timestamp": "string",
    "release_contents": [],
    "release_notes_ticket": "string",
    "replication_role": "string",
    "status": "string"
  }
]

400 Bad Request

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

403 Forbidden

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

404 Not Found

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

429 Too Many Requests

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

500 Internal Server Error

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

---

---

GetDeploymentsExternalV1

Get deployment resources by ids

Method GET

Route /deployment-coordinator/entities/deployments/external/v1

Scope Deployment Coordinator: READ

PEP 8 get_deployments

Parameters

ids query · string or list of strings

release version ids to retrieve deployment details

parameters query · dictionary

Full query string parameters payload in JSON format. Not required when using other keywords.

Authorization body · string

authorization header.

Code Examples

Python

PEP 8

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.get_deployments(ids=id_list, Authorization="string")
print(response)

Operation ID

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.GetDeploymentsExternalV1(ids=id_list, Authorization="string")
print(response)

Uber

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.command("GetDeploymentsExternalV1",
                          ids=id_list)
print(response)

PowerShell

Examples coming soon.

Go

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/deployments"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  response, err := client.Deployments.GetDeploymentsExternalV1(
    &deployments.GetDeploymentsExternalV1Params{
      Ids: []string{"ID1", "ID2", "ID3"},
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

TypeScript

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.deployments.getDeploymentsExternalV1(
  "string",  // authorization
  ["ID1", "ID2", "ID3"],  // ids
  "string"  // xCSUSERNAME
);

console.log(response);

Rust

use rusty_falcon::apis::deployments_api::get_deployments_external_v1;
use rusty_falcon::easy::client::FalconHandle;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let response = get_deployments_external_v1(
        &falcon.cfg,  // configuration
        "string",  // authorization
        vec!["string".to_string()],  // ids
        Some("string"),  // x_cs_username
    ).await.expect("API call failed");

    println!("{:?}", response);
}

Ruby

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::Deployments.new

response = api.get_deployments_external_v1('string', ['ID1', 'ID2', 'ID3'])

puts response

Responses

200 OK

[
  {
    "complete_timestamp": "string",
    "id": "string",
    "modified_by": "string",
    "modified_timestamp": "string",
    "rings": [],
    "start_timestamp": "string",
    "status": "string",
    "template_id": "string"
  }
]

400 Bad Request

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

403 Forbidden

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

404 Not Found

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

429 Too Many Requests

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

500 Internal Server Error

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

---

---

GetEntityIDsByQueryPOST

returns the release notes for the IDs in the request

Method POST

Route /deployment-coordinator/entities/release-notes/GET/v1

Scope Deployment Coordinator: READ

PEP 8 get_release_notes_v1

Parameters

body body · dictionary

Full body payload as JSON formatted dictionary.

i_ds body · array

IDs body · array

IDs body · array

Authorization body · string

authorization header.

Code Examples

Python

PEP 8

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.get_release_notes_v1(ids=id_list, Authorization="string")
print(response)

Operation ID

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.GetEntityIDsByQueryPOST(ids=id_list, Authorization="string")
print(response)

Uber

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

body_payload = {
    "ids": ["string"]
}

response = falcon.command("GetEntityIDsByQueryPOST", body=body_payload)
print(response)

PowerShell

Examples coming soon.

Go

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/release_notes"
  "github.com/crowdstrike/gofalcon/falcon/models"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  response, err := client.ReleaseNotes.GetEntityIDsByQueryPOST(
    &release_notes.GetEntityIDsByQueryPOSTParams{
      Body: &models.ReleasenotesEntitiesGetRequest{
        Ids: []string{"string"},
      },
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

TypeScript

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.releaseNotes.getEntityIDsByQueryPOST(
  "string",  // authorization
  {  // body
      IDs: []
  },
  "string"  // xCSUSERNAME
);

console.log(response);

Rust

use rusty_falcon::apis::release_notes_api::get_entity_ids_by_query_post;
use rusty_falcon::easy::client::FalconHandle;
use rusty_falcon::models::ReleasenotesEntitiesGetRequest;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let body = ReleasenotesEntitiesGetRequest {
        i_ds: vec!["string".to_string()],
        ..Default::default()
    };

    let response = get_entity_ids_by_query_post(
        &falcon.cfg,  // configuration
        "string",  // authorization
        body,  // body
        Some("string"),  // x_cs_username
    ).await.expect("API call failed");

    println!("{:?}", response);
}

Ruby

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::ReleaseNotes.new

body = Falcon::ReleasenotesEntitiesGetRequest.new(
  IDs: []
)

response = api.get_entity_ids_by_query_post(body, 'string')

puts response

Responses

200 OK

[
  {
    "categories": [],
    "early_access": "string",
    "general_availability": "string",
    "notes": [],
    "timestamp": "string",
    "version": "string"
  }
]

400 Bad Request

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

403 Forbidden

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

404 Not Found

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

429 Too Many Requests

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

500 Internal Server Error

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

---

---

GetEntityIDsByQueryPOSTV2

returns the release notes for the IDs in the request with EA and GA dates in ISO 8601 format

Method POST

Route /deployment-coordinator/entities/release-notes/GET/v2

Scope Deployment Coordinator: READ

PEP 8 get_release_notes

Parameters

body body · dictionary

Full body payload as JSON formatted dictionary.

i_ds body · array

IDs body · array

IDs body · array

Authorization body · string

authorization header.

Code Examples

Python

PEP 8

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.get_release_notes(ids=id_list, Authorization="string")
print(response)

Operation ID

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

response = falcon.GetEntityIDsByQueryPOSTV2(ids=id_list, Authorization="string")
print(response)

Uber

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

id_list = 'ID1,ID2,ID3'  # Can also pass a list here: ['ID1', 'ID2', 'ID3']

body_payload = {
    "ids": ["string"]
}

response = falcon.command("GetEntityIDsByQueryPOSTV2", body=body_payload)
print(response)

PowerShell

Examples coming soon.

Go

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/release_notes"
  "github.com/crowdstrike/gofalcon/falcon/models"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  response, err := client.ReleaseNotes.GetEntityIDsByQueryPOSTV2(
    &release_notes.GetEntityIDsByQueryPOSTV2Params{
      Body: &models.ReleasenotesEntitiesGetRequest{
        Ids: []string{"string"},
      },
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

TypeScript

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.releaseNotes.getEntityIDsByQueryPOSTV2(
  "string",  // authorization
  {  // body
      IDs: []
  },
  "string"  // xCSUSERNAME
);

console.log(response);

Rust

use rusty_falcon::apis::release_notes_api::get_entity_ids_by_query_postv2;
use rusty_falcon::easy::client::FalconHandle;
use rusty_falcon::models::ReleasenotesEntitiesGetRequest;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let body = ReleasenotesEntitiesGetRequest {
        i_ds: vec!["string".to_string()],
        ..Default::default()
    };

    let response = get_entity_ids_by_query_postv2(
        &falcon.cfg,  // configuration
        "string",  // authorization
        body,  // body
        Some("string"),  // x_cs_username
    ).await.expect("API call failed");

    println!("{:?}", response);
}

Ruby

require "crimson-falcon"

Falcon.configure do |config|
  config.client_id = ENV["FALCON_CLIENT_ID"]
  config.client_secret = ENV["FALCON_CLIENT_SECRET"]
  config.cloud = ENV["FALCON_CLOUD"]
end

api = Falcon::ReleaseNotes.new

body = Falcon::ReleasenotesEntitiesGetRequest.new(
  IDs: []
)

response = api.get_entity_ids_by_query_postv2(body, 'string')

puts response

Responses

200 OK

[
  {
    "categories": [],
    "early_access": "string",
    "general_availability": "string",
    "notes": [],
    "timestamp": "string",
    "version": "string"
  }
]

400 Bad Request

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

403 Forbidden

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

404 Not Found

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

429 Too Many Requests

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

500 Internal Server Error

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

---

---

QueryReleaseNotesV1

Queries for release-notes resources and returns ids

Method GET

Route /deployment-coordinator/queries/release-notes/v1

Scope Deployment Coordinator: READ

PEP 8 query_release_note_ids

Parameters

filter query · string

FQL query specifying filter parameters.

limit query · integer

Maximum number of records to return.

offset query · string

Starting pagination offset of records to return.

sort query · string

Sort items by providing a comma separated list of property and direction (eg name.desc,time.asc). If direction is omitted, defaults to descending.

parameters query · dictionary

Full query string parameters payload in JSON format. Not required when using other keywords.

Authorization body · string

authorization header.

Code Examples

Python

PEP 8

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

response = falcon.query_release_note_ids(filter="string",
                                         limit=integer,
                                         offset="string",
                                         sort="string",
                                         Authorization="string")
print(response)

Operation ID

from falconpy import Deployments

falcon = Deployments(client_id=CLIENT_ID,
                     client_secret=CLIENT_SECRET
                     )

response = falcon.QueryReleaseNotesV1(filter="string",
                                      limit=integer,
                                      offset="string",
                                      sort="string",
                                      Authorization="string")
print(response)

Uber

from falconpy import APIHarnessV2

falcon = APIHarnessV2(client_id=CLIENT_ID,
                      client_secret=CLIENT_SECRET
                      )

response = falcon.command("QueryReleaseNotesV1",
                          filter="string",
                          limit=integer,
                          offset="string",
                          sort="string")
print(response)

PowerShell

Examples coming soon.

Go

package main

import (
  "context"
  "fmt"
  "os"

  "github.com/crowdstrike/gofalcon/falcon"
  "github.com/crowdstrike/gofalcon/falcon/client/release_notes"
)

func main() {
  client, err := falcon.NewClient(&falcon.ApiConfig{
    ClientId:     os.Getenv("FALCON_CLIENT_ID"),
    ClientSecret: os.Getenv("FALCON_CLIENT_SECRET"),
    Context:      context.Background(),
  })
  if err != nil {
    panic(err)
  }

  limit := int64(0)
  offset := "string"
  sort := "string"

  response, err := client.ReleaseNotes.QueryReleaseNotesV1(
    &release_notes.QueryReleaseNotesV1Params{
      Filter: "string",
      Limit: &limit,
      Offset: &offset,
      Sort: &sort,
      Context: context.Background(),
    },
  )
  if err != nil {
    panic(falcon.ErrorExplain(err))
  }

  fmt.Printf("%+v\n", response.Payload)
}

TypeScript

import { FalconClient } from "crowdstrike-falcon";

const client = new FalconClient({
  cloud: process.env.FALCON_CLOUD!,
  clientId: process.env.FALCON_CLIENT_ID!,
  clientSecret: process.env.FALCON_CLIENT_SECRET!,
});

const response = await client.releaseNotes.queryReleaseNotesV1(
  "string",  // authorization
  "string",  // xCSUSERNAME
  "string",  // filter
  integer,  // limit
  "string",  // offset
  "string"  // sort
);

console.log(response);

Rust

use rusty_falcon::apis::release_notes_api::query_release_notes_v1;
use rusty_falcon::easy::client::FalconHandle;

#[tokio::main]
async fn main() {
    let falcon = FalconHandle::from_env().await.expect("Could not authenticate");

    let response = query_release_notes_v1(
        &falcon.cfg,  // configuration
        "string",  // authorization
        Some("string"),  // x_cs_username
        Some("string"),  // filter
        Some(integer),  // limit
        Some("string"),  // offset
        Some("string"),  // sort
    ).await.expect("API call failed");

    println!("{:?}", response);
}

Ruby

Examples coming soon.

Responses

200 OK

[
  "string"
]

400 Bad Request

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

403 Forbidden

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

404 Not Found

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

429 Too Many Requests

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}

500 Internal Server Error

{
  "errors": [
    {
      "code": 0,
      "id": "string",
      "message": "string"
    }
  ],
  "meta": {
    "pagination": {
      "limit": 0,
      "offset": 0,
      "total": 0
    },
    "powered_by": "string",
    "query_time": 0.0,
    "trace_id": "string",
    "writes": {
      "resources_affected": 0
    }
  }
}