Registry / type-stubs / mypy-boto3-organizations

mypy-boto3-organizations

JSON →
library1.43.73pypypi✓ verified 29d ago

mypy-boto3-organizations provides type annotations for the `boto3` AWS SDK's Organizations service. It enhances static type checking with tools like `mypy` and `pyright`, offering improved code quality and IDE support. This package, currently at version 1.42.83, is automatically generated by `mypy-boto3-builder` and frequently updated to maintain compatibility with `boto3` releases.

pip install mypy-boto3-organizations
INSTALL
IMPORT
SIG · MYPY-BOTO3-ORGANIZ
M
mypy-boto3-organizations
type-stubspythonv1.43.73
Install
3.5s avg
Import
—
Disk
18MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v1.43.73 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.910 runs
installs and imports cleanly · install 0.0s · import 0.000s · 20MB
glibc
py 3.10–3.910 runs
installs and imports cleanly · install 3.5s · import 0.000s · 20MB
18MB installed
● package 18MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

OrganizationsClient
✓ from mypy_boto3_organizations import OrganizationsClient
✗ from mypy_boto3_organizations.client import OrganizationsClient
Client
✓ from mypy_boto3_organizations import Client
ServiceResource
✓ from mypy_boto3_organizations import ServiceResource

Demonstrates how to use `mypy-boto3-organizations` to type-hint a `boto3` Organizations client and its method calls, including request and response `TypeDef` objects. This allows static analysis tools to validate your AWS API interactions.

import boto3 from mypy_boto3_organizations import OrganizationsClient from mypy_boto3_organizations.type_defs import CreateAccountRequestTypeDef, CreateAccountResponseTypeDef def create_aws_account(account_name: str, email: str, role_name: str) -> CreateAccountResponseTypeDef: """Creates a new AWS account within an organization.""" client: OrganizationsClient = boto3.client("organizations") request: CreateAccountRequestTypeDef = { "Email": email, "AccountName": account_name, "RoleName": role_name, "Tags": [ {"Key": "Project", "Value": "MyProject"} ] } response: CreateAccountResponseTypeDef = client.create_account(**request) print(f"Account creation requested: {response['CreateAccountStatus']['State']}") print(f"Account ID: {response['CreateAccountStatus'].get('AccountId', 'N/A')}") return response # Example usage (requires AWS credentials configured for Organizations service) if __name__ == "__main__": # In a real scenario, use unique values and ensure email is valid # and not already associated with an AWS account. # Replace with actual email and account name for testing. test_account_name = "MyTestOrgAccount" test_email = "test-account-owner@example.com" # Use a real, unique email test_role_name = "OrganizationAccountAccessRole" try: # This call will actually attempt to create an account in your AWS Organizations. # Be cautious when running this in a production environment. # For demonstration purposes, we'll comment out the actual call. # response = create_aws_account(test_account_name, test_email, test_role_name) print("To run, uncomment the create_aws_account call with valid parameters.") except Exception as e: print(f"An error occurred: {e}")
Debug
Known issues
breakingSupport for Python 3.8 was removed in `mypy-boto3-builder` version 8.12.0. Consequently, `mypy-boto3-organizations` (and other generated stubs) now require Python 3.9 or newer.
fix
Upgrade your Python environment to 3.9 or higher.
affects: mypy-boto3-builder >= 8.12.0, mypy-boto3-organizations >= 1.42.83 (as generated)
breakingThe `mypy-boto3-builder` migrated to PEP 561-compliant packages in version 8.12.0. While this generally improves type checker compatibility, users might need to ensure their `mypy` or `pyright` configurations correctly resolve type stubs.
fix
Verify your type checker (e.g., mypy) is up-to-date and configured to correctly find stub packages. No direct code change is usually needed unless custom stub resolution paths were used.
affects: mypy-boto3-builder >= 8.12.0, mypy-boto3-organizations >= 1.42.83 (as generated)
breakingTypeDef naming conventions changed in `mypy-boto3-builder` 8.9.0. Specifically, packed method arguments may use shorter names (e.g., `CreateDistributionRequestRequestTypeDef` became `CreateDistributionRequestTypeDef`). This applies to all generated service stubs, including Organizations.
fix
Update your code to use the new, shorter TypeDef names for request/response bodies as per the updated generated stubs. Consult the specific service's documentation for the correct TypeDef names.
affects: mypy-boto3-builder >= 8.9.0
gotchaFor optimal IDE auto-completion and static analysis, it is recommended to explicitly type-hint `boto3.client` calls with the imported client type (e.g., `client: OrganizationsClient = boto3.client("organizations")`), especially when using standalone service stub packages like `mypy-boto3-organizations`.
fix
Add explicit type annotations to your `boto3.client` and `session.client` calls to leverage full type-checking benefits.
affects: All versions
gotchaThe `mypy-boto3` library is a legacy package. The current recommendation for `boto3` type annotations is to use `boto3-stubs` (for a collection of services) or specific standalone packages like `mypy-boto3-organizations`.
fix
If migrating from `mypy-boto3`, switch to `boto3-stubs` or the relevant `mypy-boto3-{service_name}` package. Ensure your imports reflect the new package structure (e.g., `from mypy_boto3_organizations import OrganizationsClient`).
affects: Older projects using `mypy-boto3` directly.
Upgrade
Version history
1.43.73latest on PyPI · released Aug 17, 2026
Audit
Dependencies
boto3requiredProvides type annotations for the boto3 library.
Agent activity
27 hits · last 30 days
node
22
Amazon
1
OpenAI (training)
1
Resources
mypy-boto3-organizations — pip install mypy-boto3-organizations · libregistry